[RFC] doc directory reorganisation & I18N

[Ian Clatworthy]

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.

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?

Ian C.