I think we should start to write some user documentation
considering we have several applications already.
Unlike frameworks, it is impossible to generate such documentation
from source code.
So we probably need to write the documentation by hand.
We also need to decide which syntax/tag system to use
and put the html'd version on web site.
In such case, I think we can use etoile's gna web page
(http://home.gna.org/etoile/)
so that all modification can be tracked.
Any suggestion for the syntax system (plain html, docbook, ReSt, etc) ?
To reduce the overhead of having tool, I personally prefer plain HTML
with some CSS.
I think there are suffficient tools out there to convert them into PDF.
That's pretty much all we need for user documentation.

Comment ?

Yen-Ju

_______________________________________________
Etoile-discuss mailing list
[email protected]
https://mail.gna.org/listinfo/etoile-discuss

Répondre à