Hi, I got Sphinx installed now (docs at http://underdark.wordpress.com/2011/12/26/how-to-install-sphinx/) and building the Cookbook worked fine.
I'll add Alexander's notes and then send a pull request. Best wishes, Anita On Mon, Dec 26, 2011 at 2:17 PM, Martin Dobias <[email protected]> wrote: > On Sun, Dec 25, 2011 at 2:32 PM, Anita Graser <[email protected]> wrote: > > Hi, > > > > I think it's time to think about how we want to organize (plugin) > developer > > documentation in the future. Currently, we have information spread over > the > > wiki, PyQGIS Cookbook and the main API documentation itself. > > > > Imho, we should decide if we want to have that kind of information in > wiki > > or the cookbook. Keeping both up to date produces unnecessary work and > > confuses those who are willing to learn plugin development. > > Hi Anita > > I would prefer to keep the cookbook as a reference guide for the > developers and merge the interesting stuff from wiki to the cookbook. > The "rst" format is better for this kind of developer documentation, > additionally sphinx (the docs generator) allows also creation of other > output formats. > > > > The advantage of the wiki approach certainly is that everyone with an > OSGeo > > account can edit it without much effort. The cookbook on the other hand > > already contains much more information. > > We could add a short section to cookbook on how to contribute (fork, > edit, make pull request). > > Regards > Martin >
_______________________________________________ Qgis-developer mailing list [email protected] http://lists.osgeo.org/mailman/listinfo/qgis-developer
