[RFC] doc directory reorganisation & I18N

[Alexander Belchenko]

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

John Arbash Meinel пишет:
> 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.

Yes, I did it. No real hard reason, no Win98 compatibility here.
We just start htm, and htm-extension question raised several times before.
I have no objections for *.html. Let's change them, and all will be happy
(and you guys stop blame me for this :-)

> 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.

Change htm -> html require some small tweaks for installer,
and because it was my initial mistake, I'll prepare the patch.

- --
[µ]
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.6 (MingW32)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org

iD8DBQFGsWCbzYr338mxwCURAtLGAJ0VrtNQ0YHxEdsAy6UPrDhqj10WQACfX6H0
iBnqfRaxR3WREMtJxYwykg4=
=++2A
-----END PGP SIGNATURE-----