Mailing List Archive

Re: [gentoo-dev] RFC: removal of digest files from the tree
Il Thursday 31 January 2008 02:00:36 Robin H. Johnson ha scritto:
> On Wed, Jan 30, 2008 at 04:14:48PM -0800, Chris Gianelloni wrote:
> > It really is best done in the tree first, so everything is correct for
> > the snapshot. We didn't have much issue last time because we push
> > "manifest1_obsolete" into the snapshot, so digests are removed, anyway,
> > but I'd *really* prefer if this were done prior to the snapshot being
> > made.
>
> Ok, so we're just blocking on the docs guys.
>
> Are they actively working on it so I can go ahead and take the digests
> out anyway?

jkt has recently committed some fix:

http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/bugzilla-howto.xml?r1=1.10&r2=1.11
http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/gentoo-ppc-faq.xml?r1=1.66&r2=1.67
http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml?r1=1.68&r2=1.69

I don't know exactly how many other docs must be changed accordingly, it's
better to ping some GDP member to get a better feedback.

Cheers,

--
Davide Cendron

Gentoo Documentation Project
Italian Lead Translator

http://www.gentoo.org/doc/it/
Re: [gentoo-dev] RFC: removal of digest files from the tree [ In reply to ]
Davide Cendron wrote:
>> Ok, so we're just blocking on the docs guys.

Well, to the best of my knowledge, nobody asked us to fix stuff.
Preferred way would be filing a bug to the docs-team that says "hey,
we're gonna deprecate all digests, could you please fix your crap so
that it doesn't recommend running `ebuild foo digest`?", but other
methods like mailing the -dev ML or pinging us on irc are fine, too.

If you don't want to be held back by our inactivity, you have to let us
know :).

Also note that docs team is responsible for files that are under
http://www.gentoo.org/doc/ and *nothing else*. If there's a bug in some
other document that is on our web nodes, like for example the Devrel
Handbook, we leave it to their maintainers (devrel here) to fix it. If
such team says "hey, fell free to fix whatever you want", I'm sure some
GDP members (including rane myself) will gladly help, but right now, the
policy is "we got a bug that speaks about stuff under /proj/ -> reassign".

(As a side note, we have that great devmanual which seems a lot more
useful than the ebuild part of the devrel handbook, perhaps it's time to
reconsider their roles. And yeah, I've brought this to devrel's
attention and don't count on them following -dev :). )

> I don't know exactly how many other docs must be changed accordingly, it's
> better to ping some GDP member to get a better feedback.

Quick grep suggests that these needs fixing:

proj/en/desktop/games/games-ebuild-HOWTO.txt
proj/en/devrel/handbook/hb-guide-ebuild.xml
proj/en/devrel/handbook/hb-introduction-new-devs.xml
proj/en/devrel/new-dev-training.xml

I'm sure that rane will get someone from the devrel to fix them :)

Cheers,
-jkt

--
cd /local/pub && more beer > /dev/mouth