[RFC] doc directory reorganisation & I18N

[John Arbash Meinel]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Robert Collins wrote:
> On Thu, 2007-08-02 at 10:46 +1000, Ian Clatworthy wrote:
>> Robert Collins wrote:
>>
>>>> 6. The whole tree below doc/ can be pushed to doc.bazaar-vcs.org/nnnn
>>>>    and that website will have comprehensive docs for each release in
>>>>    one or more languages.
>>>>
>>>> Does this sound good to everyone? If not, please suggest what you'd like
>>>> to see instead.
>>> It sounds good. We already do 6 right? Or are you suggesting some change
>>> there?
>> 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.
> 
>> In fact, one thing I forgot to suggest was fixing the htm suffix at the
>> same time. I'd like to make that html now for much the same reason:
>> let's get the doc URLs 'right' if we're changing them anyway. So let me add:
>>
>> 7. Change the htm suffix to html.
>>
>> I gather there's some history here I'm not aware of, e.g. Win98 support?
> 
> No idea. .htm is three letter though, so it may be better for windows. 
> 
> -Rob
> 

I believe Alexander was the one who put things together. And he just defaulted
to .htm. And we stuck with it for consistency.

IIRC, he didn't have a specific need to do so. So I think if we have a reason
to change it, we can do so.

Also, be aware that one issue we had was that the packager was changing .htm =>
.html, and they had to switch it back. I'm guessing that if we change it, it
will just propagate, though.

John
=:->

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.7 (Darwin)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org

iD8DBQFGsS5tJdeBCYSNAAMRAgAMAKDBSxbQzgL2D3vE3wk26AlkXOt5awCcDYfG
S3O6KwR8BfNVBkCZwkqbeFk=
=I2T2
-----END PGP SIGNATURE-----