Re: [gentoo-dev] GLEP #10 -- Proposal for restructuring the CVS regarding documentation wrt internationalization proposal

[Kurt Lieber]

On Mon, Aug 04, 2003 at 08:31:08PM +0200 or thereabouts, Sven Vermeulen wrote:
> http://www.gentoo.org/proj/en/glep/glep-0010.html

> All feedback appreciated, especially from the infrastructure folks as it is
> mainly infrastructure related.

OK, so I finally had a chance to review and think about this GLEP.  Below
are some questions/comments that I have.

1) I'd like Robin (robbat2) to comment on this since the primary reason for
the GLEP seems to be better control over CVS permissions.  I know Robin has
some ideas on how he wants to change CVS permissions, so his feedback here
is important. (cc'd on this email)

2) One thing that isn't clear in the GLEP.  Is
http://www.gentoo.org/${LANGUAGE} an *exact* copy of
http://www.gentoo.org/en/?  Or are the internationalization teams allowed
to change things?  For the most part, I would like to ensure that we have
one, consistent web site, so I'd like to see translations happening, but
not alternate content per se.

You touch a bit upon this in the "Internationalized Website" but I'm still
not clear on how it works, so some clarification would be appreciated.

3) Regarding permissions, I don't really like the idea of the entire docs
team having commit access to /en/main/.  I realize that's the case now
because of where docs.xml resides, but if we're going to restructure things
then I'd like to change that.  Ideally, I would like members of cvsdoc to
have commit access to /en/docs/ and the cvsweb group to have commit access
to /en/main/.  cvswebdoc is a nasty hack of a solution created because of
our current structure.  I'd like to see it killed off as part of this
restructure.

4) How do /en/proj/* pages get translated?

5) One significant problem we have with the GWN is translation teams not
keeping things up to date.  This may be outside of the scope of this GLEP,
but I'd sure like to see a defined policy that states what is expected of
the translation teams and at what point a language will be "killed off"
from the web site for falling behind.  We *do not* want to have
/<language>/doc/gentoo-x86-install.xml handing out the wrong information.
If we can't keep a language up to date, it should be removed entirely imo.

6) Backwards compatibility needs to be maintained.  Think of all the
external links to http://www.gentoo.org/doc/en/gentoo-x86-install.xml on
other sites.  We can't simply cause all of them to break.  We can do some
fancy footwork with mod_rewrite to facilitate this, but the GLEP needs to
be updated to reflect the fact that we *will* make a best effort to
maintain backwards compatibility.