Conversion to SVN

[Glen Barber]

On 10/7/11 1:38 PM, Ulrich Spörlein wrote:
>>> I think it would be beneficial to provide a "versioned" FreeBSD
>>> Handbook.  The PostgreSQL documentation folks do this [1] - you can find
>>> documentation that was specific to a particular release, so you can
>>> determine if something you have found in the docs appropriately matches
>>> the version you are running. [2]
>>>
>
> I have no good idea on how to fit stuff like -CURRENT becoming a release
> into this scheme, however. 

With a versioned Handbook, we can publish the version for -CURRENT as
well as the supported releases.  This can get more eyes on what _will_
be released with regards to the documentation, get outdated content
issues resolved prior to the release, and lessen the influx of doc PRs
post-release.

> Perhaps some special tags can be introduced that only make content visible,
> once we have released 9.0.

We already have this.  See www/share/sgml/release.ent and
www/en/where.sgml for a good example, specifically the "Help Test"
section of where.sgml.

> That way you can write
> 
> On FreeBSD 6.0 and below you have to use foo.
> On versions 7.x and 8.x you need to do bar.
> <magic>Starting with 9.0 you need to use baz.</magic>
> 

This is exactly what I'd like to be able to stop doing, particularly in
large chapters.

But, that's all I'll say about it for now, because it's not directly
related to the original post.

Just pointing out I'd like to see a move to svn, as well, while giving a
developmental reason why.

Regards,

Glen

-- 
Glen Barber | gjb at FreeBSD.org
FreeBSD Documentation Project