[mapserver-dev] Documentation Updates

[Tamas Szekeres]

Howard,

It looks really cool!
Just looking into the docs I'm not sure how the docs should properly
reference to each other. It seems we should alter the previous approach in
the documents, like for
http://iowa.hobu.biz/msdocs/build/html/references/mapscript/dotnet_compile.htmlto
avoid the warning.
Should we continue keep the doc along with the code in different directories
or you're planning to set up a central repository somewhere?
In my case the C# readme is the same as the compile doc exposed to the web
site, so it would be reasonable to keep this doc in place.

Best regards,

Tamas


 PS: I'd apply for removing the trailing 't' char in my surname in the docs.
My nickname (szekerest) contains just the abbreviation of 'tamas' in the end
:-D  This is because the Hungarians use reverse name ordering (surname
firstname) by default, causing various kind of unexpected problems for us in
various places ;-)




2008/11/24 Howard Butler <hobu.inc at gmail.com>

> 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
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.osgeo.org/pipermail/mapserver-dev/attachments/20081124/8b55f3b8/attachment.html