I am playing an io script to generate a document of Etoile project based on README. The idea is to have an update-to-date document. It is understandable that people have less time maintaining the wiki. It also solves one of the issues that people have no idea what's inside Etoile and the naming. In order to make the script work well, the format of README has to be unified. I think it would be better in structured text which can be converted into other format. Here are two options I personally like: Stx2Any: http://sange.fi/~atehwa/cgi-bin/piki.cgi/stx2any ReST: http://docutils.sourceforge.net/rst.html
I like Stx2Any more on its syntax in plain text format, which I think is more important. Most people read README straight. Since I have less time working on real stuff recently, I can go through all the projects and reformat the README into structured text and finish up the script. Any comment, especially regarding the choice of structured text ? Yen-Ju _______________________________________________ Etoile-discuss mailing list [email protected] https://mail.gna.org/listinfo/etoile-discuss
