From: Junio C Hamano <gitster@pobox.com>
Date: Fri, 10 Feb 2012 21:38:31 GMT
Subject: Re: Git documentation at kernel.org
Message-ID: <7vsjiinzc8.fsf@alter.siamese.dyndns.org>
In-Reply-To: <20120210212030.GD5381@thunk.org>

Ted Ts'o <tytso@mit.edu> writes:

> Hmm... good point.  That does make it hard.  I could imagine making it
> work by having separate hierarchies, and then using apache rewrite
> rules so that anything that doesn't begin with vX.Y.Z in the top level
> of software/scm/git/docs/* gets redirected to LATEST/*, where LATEST is
> a symlink that is managed via kup.

We could move vX.Y.Zs out of scm/git/docs/ hierarchy.  The existing links
from external sites rarely point at a documentation page of a specific
version, I suspect.

People can be trained to look at scm/git/old-docs/vX.Y.Z when they want to
see how older command set looked like, even those who know that in olden
days they would have consulted scm/git/docs/vX.Y.Z for that information;
they are much less of a problem than existing pages whose links want to
stay working.