Re: [RFC] Decommissioning of Documentation Project and move to Wiki Project

joshua saddler <[email protected]> Mon, 1 Aug 2016 19:15:51 -0700
Newsgroups gmane.linux.gentoo.documentation
Message-ID <[email protected]>
> On Aug 1, 2016, at 10:24 AM, Sven Vermeulen <[email protected]> wrote:
>=20
> Hi all,
>=20
> As mentioned in a previous mail, we're going to decommission the =
Gentoo
> Documentation Project (for now) and put all documentation development
> efforts under the Gentoo Wiki Project umbrella. I am suggesting the
> following approach to do so, in a gently manner.
>=20
> I don't think there is a need for a waiting period between steps, but =
I
> won't hurry the actions either. Step 5 will probably take a while =
anyway.
>=20
> Please take a look at this and see if I'm forgetting something or not.
>=20
> Wkr,
> 	Sven Vermeulen
>=20
> =
##########################################################################=
###
>=20
> 1. Update Gentoo Documentation Project wiki page with notification
>=20
> I am going to add a warning on the Documentation Project wiki page to =
inform
> readers that the project is being decommissioned, with an explanation =
why
> (roughly, all documentation development is now purely done as wiki =
edits, no
> need for an overarching project).
>=20
> 2. Remove links to Project:Documentation/Overview
>=20
> This page was initially meant to give pointers to actively "edited" =
pages,
> but the quality of various articles is already quite good, and there =
are not
> many editors aware of how this overview was kept up-to-date (if at =
all).
>=20
> The page is linked from a few locations (main wiki page, as well as
> handbooks). Instead, I'll update those to point to the main wiki page =
(which
> has "Documentation topics" under "Available documentation") as the =
best
> entry point to the remainder of Gentoo's documentation.
>=20
> 3. Move "active" Project:Documentation docs to Project:Wiki
>=20
> If I am not mistaken, there is a single document that is still quite =
active
> and needed, which is Project:Documentation/Handbook_Development. I am =
going
> to move that document to Project:Wiki as the document explains how the
> handbook is maintained on the wiki.
>=20
> All other documents will be mentioned under the "Obsolete" section of =
the
> documentation project site, and they will all receive an obsolete =
message on
> top of the article.
>=20
> 4. Remove all members from Gentoo Documentation Project
>=20
> I will remove all members from the Gentoo Documentation Project and =
its
> subproject, the Gentoo Documentation Translation Project. A single =
user will
> remain (myself) with indication that it is for housekeeping until =
final
> removal.
>=20
> Note that there will be two developers (jkt and jaaf) who will no =
longer
> have any active project associated with them!
>=20
> 5. Remove references to Gentoo Documentationn Project from =
*.gentoo.org
>=20
> Go through the various resources that we have and ensure that there =
are no
> references towards the GDP anymore (or at least not as an active =
project).
>=20
> 6. Drop infrastructural support for Gentoo Documentation
>=20
> Next, the infrastructural services for the Gentoo Documentation will =
be
> cleaned up. This means mailinglists and aliases (I don't think there =
is a
> repository specific to the GDP).
>=20
> 7. Remove Project:Documentation from the wiki
>=20
> Finally, clean up the last traces of the GDP from the wiki.

does this mean that existing GDP members should add ourselves to the =
Wiki project(1) to list our continued involvement in maintaining the =
wiki docs?

(1) https://wiki.gentoo.org/wiki/Project:Wiki=