[OpenLayers-Dev] Additional Documentation

Eric Lemoine eric.c2c at gmail.com
Thu Nov 13 15:25:19 EST 2008

I'm not a rst user so I can't comment on it. Using SVN for text format
docs makes great sense to me. +1. Eric

2008/11/13, Christopher Schmidt <crschmidt at metacarta.com>:
> I've been maintaining
> http://crschmidt.net/~crschmidt/spherical_mercator.html for the past 11
> months in my own personal SVN server.
> (http://svn.crschmidt.net/personal/openlayers/doc/)
> I would like to stp doing that, and put it instead in OpenLayers SVN. It
> seems t me that we cuold be writing a number of documents like this --
> single page sheets about a particular feature of OpenLayers. My hope is
> that if we were to have a central location for these things:
> 1. People would be more able to find them.
> 2. We woul dhave a centralized place to host translations/other related
>    materials.
> 3. We could integrate deployment of these materials onto openlayers.org
>    somewhere more easily.
> I understand that some people will continue to maintain their own
> seperate repositories for documents as well, adn I'm not arguing against
> that, of course.
> What I would like to do is:
>  * Create http://svn.openlayers.org/trunk/doc/
>  * Check in the build directory from the SVN above
>  * Create a "spherical_mercator" subdirectory
>  * Check in the spherical_mercator.rst file
>  * Add a 'build' script that will iterate over directories, looking for
>    potential RST to build.
> The only reason to put the build tools above is that I believe this
> particular
> Then, as we build up more documentation, we have a framework for more
> prose documentatin like this: simply create a subdirectory for it, and
> any neccesary information can be stored alongside it.
> I believe that translations of documents could also be managed this way:
> simply have a spherical_mercator.fr.rst document alongside the English
> one, for example.
> At this time, I'm not proposing commit status for this directory be
> given to people who don't already have trunk commit, but we can imagine
> making this sectino more 'open' to other committers (possibly even all
> of our sandbox users), since commits are less likely to 'break' things.
> I guess this type of thing really should be a PSC vote, so:
> Does anyone have any objections to creating trunk/doc/, putting some
> useful build utils in it, as well as creating subdirectories for
> individual prose documentation efforts, starting with the
> spherical_mercator.rst describe above?
> I'll start off by saying I'm +1.
> Regards,
> --
> Christopher Schmidt
> MetaCarta
> _______________________________________________
> Dev mailing list
> Dev at openlayers.org
> http://openlayers.org/mailman/listinfo/dev

More information about the Dev mailing list