On Mon, Aug 08, 2005 at 01:10:03PM +0200, Lars Weiler wrote:
> I didn't answered as I created the ppc-docs myself from our
> current and updated handbook-draft.
>
> Thanks for your help, but your first message was already too
> late.
I'm quite disappointed that the Release Engineering Guidelines [1] aren't
followed. Quite a lot of developers apparently think that, once the
installation media are created, the release is done. This isn't true and to
make this more clear, the guidelines were created.
As the documentation "liason" I am of course talking about documentation.
There are a few steps mandatory in that process that seem to be forgotten
this release:
** Is the installation documentation up-to-date?
The Arch Release Coordinator should be in contact with the releng
documentation liaison at all times to ensure that the documentation released
is in sync with the release itself.
** Does the Gentoo Documentation Project (GDP) have all of the necessary
** information required for the release documentation?
The GDP requires a listing of all bootable kernels on each bootable LiveCD,
a listing of all supported boot options on each bootable LiveCD, the output
of find on a mounted CD from each category (both bootable LiveCDs and a
Packages CD), and the output of find on a booted universal/ minimal LiveCD.
The information can be sent to the releng GDP liaison, who is listed on the
releng Project Page.
It is in my opinion also important that the Gentoo developers are aware that
a release is pending, at least 24h in advance. The Gentoo Documentation team
needs time to migrate the draft/2005.1 to the official location and prepare
to update the current Handbook (for Internet-based installations).
Where are we going at? This morning I woke up only to see massive confusion
on #gentoo-dev. No-one knew that 2005.1 was released (if it is), infra said
they weren't ready yet, the GDP wasn't informed, I found nothing on -core
except beejay's e-mail telling he left (can't blame him). Not even a message
to pr-aBrp7R+bbdUdnm+yROfE0A@xxxxxxxxxxxxxxxx or
gentoo-pr-aBrp7R+bbdUdnm+yROfE0A@xxxxxxxxxxxxxxxx to discuss the Press Release.
Look, I'm not the lead PR anymore, but if someone thinks he can just add
documentation to the Gentoo Documentation Project without consulting the
GDP, I would give him a nice slap with a big catfish.
[1] http://www.gentoo.org/proj/en/releng/docs/release_guidelines.xml
--
Documentation project leader - Gentoo Foundation Trustee
The Gentoo Project <<< http://www.gentoo.org >>>
pgpuXnwXLeUbv.pgp
Description: PGP signature
|