The Sphinx project ( http://sphinx.pocoo.org/ ) has been running since 2008 and seems to be actively maintained. It requires Python 2.4 (minimum) and a few extra Python libs: http://sphinx.pocoo.org/intro.html#prerequisites
sites at: http://matplotlib.sourceforge.net/ and http://www.florian-diesch.de/doc/python-und-glade/online/ use sphinx in what appears to me to be a good way ... There are others out there that use Sphinx in a bad way IMHO. I don't know if this is the way that the website guys want to go, or even whether it's flexible enough or not. Jon On 26 May 2011 14:54, Tobias Famulla <[email protected]> wrote: > Hello OpenIndiana-Community, > > I am in an Open-Source-seminar at University, in which we have to hold a > presentation about an Open-Source project and participate in the > development-process of this project. > > I chose OpenIndiana for this Course, because I think it is an interesting > young project and the developement of a free Solaris is important for the > open-source-community. > > Becaus it lacks in a good documentation of OpenIndiana yet, as far as i read > in the wiki, I had the idea of writing a script to transform the latest > OpenSolaris documentation from XML to a > Sphinx-documentation(restructuredText) and rewrite it in some parts. I think > Sphinx is a wonderful tool to write a good documentation and export it to > html and pdf. It might be easier to handle these documents than the XML > ones. > > If you like the idea of writing the OpenSolaris-documentation in Sphinx, it > might be helpful to integrate it in the revision control system to have an > easy way to manage the documentation. > > On another point, it would help me for the presentation, if someone writes > me, how decisions for the project are made and how the project is > managed(commitments to the sourcetree and something like that) > > Sincerely yours, > > Tobias Famulla > > _______________________________________________ > OpenIndiana-discuss mailing list > [email protected] > http://openindiana.org/mailman/listinfo/openindiana-discuss > _______________________________________________ OpenIndiana-discuss mailing list [email protected] http://openindiana.org/mailman/listinfo/openindiana-discuss
