[mapserver-dev] docs and branches...

[Frank Warmerdam]

Daniel Morissette wrote:
> Steve Lime wrote:
>> Hi all: What are the plans for the docs relative to branching. Are we 
>> going to branch the
>> docs or just maintain things in the trunk? I think this matters for 
>> setting up a mapserver_docs
>> svn access group.
>>
> 
> I'd lean towards branching docs for every release, but my understanding 
> from our IRC meeting on docs a few weeks ago was that the majority saw 
> no point in branching docs and wanted to have a single set of docs 
> always living in trunk.
> 
> We should probably wait to hear back from Jeff on this but I think he'll 
> be back only at the end of the week.

Daniel,

I took a different impression away from that meeting.  I understood we
would be branching and tagging docs along with the source code and that
a packaged copy of html and pdf docs would be available for download on
the download site with major releases.

Also that on the web site we would eventually offer html docs for older
versions though the primary web site view would be the "trunk" docs.
Also that the trunk docs would attempt to describe when new features
were added so that folks using older versions would have some sense of
whether the feature applies to their version or not.  I'm a bit unclear
on how far this will be taken.

Best regards,
-- 
---------------------------------------+--------------------------------------
I set the clouds in motion - turn up   | Frank Warmerdam, warmerdam at pobox.com
light and sound - activate the windows | http://pobox.com/~warmerdam
and watch the world go round - Rush    | Geospatial Programmer for Rent