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=