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

[Jon Tai <jon tgpsolutions com>]

I posted this four days ago but got no response, so here goes again.  
I re-wrote the site (available for viewing at 
http://balsa.tgpsolutions.com) and added new screenshots of 
balsa-1.2.1, and so far I haven't seen any comments either for or 
against the "new" design; it is basically a cleanup of the current site 
with a unified navigation.  I would be happy to add more FAQ's at a 
later date.  Does anyone know who is in charge of balsa.net?

- Jon


On 2001.10.22 15:32 Pawel Salek wrote:
> 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/