[RFC] doc directory reorganisation & I18N

[Dennis Benzinger]

Am Thu, 02 Aug 2007 10:57:16 +1000
schrieb Robert Collins <robertc at robertcollins.net>:

> On Thu, 2007-08-02 at 10:46 +1000, Ian Clatworthy wrote:
> > [...]
> > Yes, we already do 6 but the current tree is English only. So there
> > will be a change to many external URLs, e.g.:
> > 
> > from:  http://doc.bazaar-vcs.org/current/tutorial.htm
> > to:    http://doc.bazaar-vcs.org/current/en/user-guide/tutorial.htm
> > 
> > My thinking was that if we were moving files anyway, let's get the
> > language code into the tree on that site below version now as well.
> 
> Ugh. HTTP has fine language negotiation support. So while the physical
> layout may change, I'd like a language mapping so that the current
> urls like http://doc.bazaar-vcs.org/current/tutorial.htm continue to
> work - and not a redirect :). This is good for a variety of reasons,
> and supports multiple languages well. We can allow access to
> the /lange/ paths too if desired, but I don't see a benefit to that.
> [...]

One benefit would be that you could easily check if the authoriative
english version is newer than the translation. With volunteer
translation you always have the problem that you don't know if the
original documentation has changed or not. If you don't have access to
the lang path you would have to change your browser settings to see the
english documentation.


Dennis Benzinger