I just reorganized the docs directory, now called "docs". I thought it would be easier to get a totally clean start, and the project is early enough that I don't think losing version history is too important. Basically, once we learned we needed to build everything at once to get the links working, all of the stuff Darren initially set up and then changed on my request was basically right so I reverted to a similar organization. Actually, I checked out the python docs and tried to follow their model as closely as possible, including the use of the rst extension. Since ipython, numpy and scipy are moving or have moved to a sphinx documentation system, the more we all follow the same conventions the easier it will be to mix and match documents, build books out of them, etc...
Every subdoc project has a index.rst file and several other rst files (since python uses rst I figures we should too). The subdoc dirs are "users", "devel", and "api". I created some symlinks in the top level "docs" directory in case we need to refer to mpl-data or the examples subdir in the rst documents w/o having to have crazy relative paths that may change. This is explained in the documenting_mpl.rst file. Let me know if you have any problems... JDH ------------------------------------------------------------------------- This SF.net email is sponsored by: Microsoft Defy all challenges. Microsoft(R) Visual Studio 2008. http://clk.atdmt.com/MRT/go/vse0120000070mrt/direct/01/ _______________________________________________ Matplotlib-devel mailing list Matplotlib-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/matplotlib-devel
