help with doc (was Re: ANNOUNCE: Balsa-1.2.1 released.)

[Pawel Salek <pawsa theochem kth se>]

Guys,

thanks for volunteering! Many people complain that the documentation of 
the open source programs is poor - and you have got chance to change this 
opinion.

Before we start changing the world (read: entire open source), let's 
change just balsa documentation.

There are actually two main tasks:

- update of the website
- update of balsa.sgml

The first one requires some knowledge of HTML, the other one - SGML. What 
is most important in both cases is the information, not the form. So, 
don't worry if you are not expert in one or another field.

Regarding the website:
- faq needs to be updated (just go through, say, last two months of 
balsa-list). some known problems may be added there as well.
- screenshots need to be updated.
- features need to be updated.
General face lift up would be appreciated but it of secondary importance. 
Again, it is the information that counts.

Regarding balsa.sgml:
- it has to be synced vs current menus, preferences.
- there are some screenshots a little bit out of date.
- informations about gtkhtml stability is not true any more.
- etc.
- this task has slightly shorter deadline: we would like to release 1.2.2 
relatively soon (just for the doc, few bug fixes and translations), 
probably within 7 days. Don't be afraid of asking for help: the primary 
objective is to get it done. Time is precious. Don't worry too much about 
formatting, again, it is the content and accuracy that counts.

Just in case, you can get current balsa.sgml from
http://www.theochem.kth.se/~pawsa/balsa/balsa.sgml
Feel free to start from scratch if you find it more convienient.

Questions, comments? I am really looking forward to this!

Pawel
PS. of course, more volunteers are welcome!
-- 
Pawel Salek, Theoretical Chemistry, SCFAB, Stockholm
http://www.theochem.kth.se/~pawsa/