[mapserver-dev] Documentation Updates
aboudreault at mapgears.com
aboudreault at mapgears.com
Mon Nov 24 08:58:04 EST 2008
Great work! Sphinx generates a very clean documentation.
Alan
-----Original Message-----
From: "Howard Butler" <hobu.inc at gmail.com>
Sent: Sunday, November 23, 2008 11:36pm
To: "mapserver-dev Mailing List" <mapserver-dev at lists.osgeo.org>
Subject: [mapserver-dev] Documentation Updates
All,
Jeff and I have been working on the documentation with the expectation
of implementing the RFC that I wrote to stop using the Plone website.
The first, and probably most important, step in that process is
migrating our reference documents to be managed in subversion and
provide a way to render a website from it.
Practically all of our references and most of our howtos were stored
as ReStructured text in the Plone site. The Python project, and a
number of other software development projects, are using Sphinx http://sphinx.pocoo.org/index.html
to manage their sets of ReStructured text. Sphinx is basically
Doxygen for ReST. Look and feel can be changed with templating and
css, but I just wanted to demonstrate organization
Here's some output that's basically a first run to give you an idea
where things are heading:
http://iowa.hobu.biz/msdocs/build/html/references/index.html
http://svn.osgeo.org/mapserver/trunk/docs/
Howard
_______________________________________________
mapserver-dev mailing list
mapserver-dev at lists.osgeo.org
http://lists.osgeo.org/mailman/listinfo/mapserver-dev
More information about the mapserver-dev
mailing list