[gentoo-project] Use of git for site/proj/docs

[gentoo-project] Use of git for site/proj/docs

[Sven Vermeulen]

Hi guys,

The gentoo CVS repository currently contains the sources for (at least) the
following things:

- the main gentoo site (through gentoo/xml/htdocs/main)
- the gentoo documentation (gentoo/xml/htdocs/doc)
- the gentoo project sites (gentoo/xml/htdocs/proj)

A long time ago, there was talk about migrating it to git. From what I heard
from Matthew, one of the things that might be interfering with this process
is that the current gentoo/xml repository is too large, is that correct?

I don't mind helping along here to get things forward.

Wkr,
	Sven Vermeulen

Re: [gentoo-project] Use of git for site/proj/docs

[Matthew Summers]

On Sat, May 26, 2012 at 1:47 PM, Sven Vermeulen <swift@gentoo.org> wrote:
> Hi guys,
>
> The gentoo CVS repository currently contains the sources for (at least) the
> following things:
>
> - the main gentoo site (through gentoo/xml/htdocs/main)
> - the gentoo documentation (gentoo/xml/htdocs/doc)
> - the gentoo project sites (gentoo/xml/htdocs/proj)
>
> A long time ago, there was talk about migrating it to git. From what I heard
> from Matthew, one of the things that might be interfering with this process
> is that the current gentoo/xml repository is too large, is that correct?
>
> I don't mind helping along here to get things forward.
>
> Wkr,
>        Sven Vermeulen
>

It is not the size that matters, but the layout of the resulting repo
or repos. I know the Foundation has discussed having it's own repo.
There is also the news/gmn/gwn dir and so on.

How should these resultant repos be structured? Are we in a position
to retire some of the dirs in gentoo/ ?

-- 
Matthew W. Summers
Gentoo Foundation Inc.

Re: [gentoo-project] Use of git for site/proj/docs

[Matthew Summers]

On Sat, May 26, 2012 at 1:47 PM, Sven Vermeulen <swift@gentoo.org> wrote:
> Hi guys,
>
> The gentoo CVS repository currently contains the sources for (at least) the
> following things:
>
> - the main gentoo site (through gentoo/xml/htdocs/main)
> - the gentoo documentation (gentoo/xml/htdocs/doc)
> - the gentoo project sites (gentoo/xml/htdocs/proj)
>
> A long time ago, there was talk about migrating it to git. From what I heard
> from Matthew, one of the things that might be interfering with this process
> is that the current gentoo/xml repository is too large, is that correct?
>
> I don't mind helping along here to get things forward.
>
> Wkr,
>        Sven Vermeulen
>

It is not the size that matters, but the layout of the resulting repo
or repos. I know the Foundation has discussed having it's own repo.
There is also the news/gmn/gwn dir and so on.

How should these resultant repos be structured? Are we in a position
to retire some of the dirs in gentoo/ ?

-- 
Matthew W. Summers
Gentoo Foundation Inc.

Re: [gentoo-project] Use of git for site/proj/docs

[Stuart Longland]

On 27/05/12 7:04 AM, Rich Freeman wrote:
> If
> recombining them for the website is a nightmare then maybe leave them
> together

Surely git submodules would help with this?
-- 
Stuart Longland (aka Redhatter, VK4MSL)      .'''.
Gentoo Linux/MIPS Cobalt and Docs Developer  '.'` :
. . . . . . . . . . . . . . . . . . . . . .   .'.'
http://dev.gentoo.org/~redhatter             :.'

I haven't lost my mind...
   ...it's backed up on a tape somewhere.

Re: [gentoo-project] Use of git for site/proj/docs

[Michał Górny]

[-- Attachment #1: Type: text/plain, Size: 666 bytes --]

On Sun, 27 May 2012 08:14:27 +1000
Stuart Longland <redhatter@gentoo.org> wrote:

> On 27/05/12 7:04 AM, Rich Freeman wrote:
> > If
> > recombining them for the website is a nightmare then maybe leave
> > them together
> 
> Surely git submodules would help with this?

No, I don't think so. The main thing about submodules is that every
submodule is bound to a specific commit. Unless the main goal here is
to step-update all three modules at once, it's not a good solution.

And in this particular case, using submodules looks like 'let's keep
two copies [hardlinks] of the same repository for no good reason'.

-- 
Best regards,
Michał Górny

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 316 bytes --]

Re: [gentoo-project] Use of git for site/proj/docs

[Sven Vermeulen]

On Sat, May 26, 2012 at 02:03:38PM -0500, Matthew Summers wrote:
> It is not the size that matters, but the layout of the resulting repo
> or repos. I know the Foundation has discussed having it's own repo.
> There is also the news/gmn/gwn dir and so on.
> 
> How should these resultant repos be structured? Are we in a position
> to retire some of the dirs in gentoo/ ?

If the repository as a whole isn't converted to a single repository, you'll
always have to deal with creating the necessary awareness towards the users
about different locations. But that doesn't mean it'll involve breakage of
anything.

Personally, I know the most about the gentoo/xml part of the repository.
Most of the things below that (like gentoo/xml/htdocs, ...) are all quite
much related to each other. A change on an XSL file might be best done
simultaneously with a change on a DTD and various XML files. So my
suggestion would be to at least keep this repository in one "set".

I know there are different privileges assigned below that (translation teams
have different commit rights than documentation editors, who have different
commit rights than website, etc.) and I don't know if git handles this too.

Otoh, for me, I don't mind if the commit rights on gentoo/xml are all put
together. After all, we don't put ACLs on gentoo-x86 either do we?

The other parts, like gentoo/misc (which hasn't seem an update in years),
gentoo/users (which I think can best be migrated to gogo on a per-user
level, and might not even require migration of the history) and gentoo/src
(which I think can be best migrated to gogo as well, but probably involves
history migration too) I know less about.

So, what if we
- focus on gentoo/xml as a migration to git
- contact the folks mentioned in gentoo/users to see if they can request a
  git repo on gogo and migrate their content themselves
- contact the projects mentioned in gentoo/src to see if they need to have a
  git repo on gogo and if so, if they need to have the commit history
  migrated as well
- put gentoo/misc in freeze

Wkr,
	Sven Vermeulen