Modified: 4 January 2009 17:28:33 EST
Author
The views expressed here are my own and do not necessarily reflect the views of my employer.
Available Feeds
Contact
-
Meta
Modified: 4 January 2009 17:28:33 EST
The views expressed here are my own and do not necessarily reflect the views of my employer.
Stefano Costa said,
Wrote on December 30, 2008 @ 04:46:17
At http://mapserver.osgeo.org/introduction.html#mapserver-overview you probably don’t want to mention Java and C among “popular scripting languages”.
Cheers,
Posted fromSteko
Epiphany 2.22 Linux
tomkralidis said,
Wrote on December 30, 2008 @ 08:18:31
Good point. We meant C# :). I’ve also added “development environments” to the text to encompass more than scripting languages. This should be updated on the main site soon. Thanks for the suggestion!
Posted fromMozilla Firefox 3.0.5 Windows XP
Yves Moisan said,
Wrote on December 30, 2008 @ 09:38:35
Lots of interest in Sphinx those days with the FeatureServer and TileCache sites recently sphinxified too. I hope Howard writes a blog entry on the move from Plone to Sphinx ‘cos I’d like to know the pros and cons. Also, it seems everyone is reporting using Sphinx 0.6 and one can only easy_install 0.5.1 ??
Cheers,
Yves Moisan
Posted fromMozilla Firefox 3.0 Linux
tomkralidis said,
Wrote on December 30, 2008 @ 09:52:02
Bonjour Yves: c’est vrai, it would be useful to have his insights. I do know there was alot of scrubbing involved (by him and others), so it was no small task. 0.6? I can’t find 0.6…http://pypi.python.org/pypi/Sphinx shows 0.5.1, and I’m using 0.5 (via yum on fc10).
Certainly a lightweight and smart approach to managing documentation. I think when the next documentation / website revamp takes place, it will be much easier given we have stuff in rST pure now.
Posted fromMozilla Firefox 3.0.5 Windows XP
Yves Moisan said,
Wrote on December 30, 2008 @ 11:13:50
Hey Tom,
I just wonder how collaboration to the docs will be handled with a tool that’s designed for documentation as opposed to a mediawiki or a Plone that are designed for collaborative authorship. In a broader “collaborative platform”, what’s the role of Sphinx ?
For example, the Grok folks have a Plone site (http://grok.zope.org/) for their home and a Sphinx docs section for the current docs (http://grok.zope.org/doc/current/). Anyhow, I’m eager to read the rationale behind the move.
Cheers,
Yves
Posted fromMozilla Firefox 3.0 Linux
Howard Butler said,
Wrote on December 30, 2008 @ 11:19:23
Yves,
My blog is defunct. You can find me on twitter, but I don’t think I’ll be blogging anymore. Everything I write these days is much longer in form, and the blogging format is too stale for me. I also feel like I don’t have too much interesting to say.
Anyway…
The advantages of Sphinx over Plone (for the MapServer community) are:
– Docs are in svn. Almost all of our document writing folks have svn access. They know how to use these tools. They don’t have to learn anything new to write docs.
– Anyone can build the docs and see them locally.
– A static website doesn’t need as much administrative tending.
– A static website doesn’t need as much computing horsepower.
– Trac can fill our role for a community website / wiki (we didn’t have this before the Plone site was developed)
– Administration and development of the website no longer has to go through the Plone expert(s). Some simple templating, some Python code, and ‘make’ are all that are needed to build the new website.
re: 0.6. We’re running that on http://mapserver.osgeo.org because of a number of PDF/LaTeX fixes. For HTML generation, there’s no significant difference right now.
Posted fromMozilla Firefox 3.0.5 Mac OS X 10