Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 648316 - Keywording/stabilization docs are duplicated and spread all over the place
Summary: Keywording/stabilization docs are duplicated and spread all over the place
Status: RESOLVED FIXED
Alias: None
Product: Documentation
Classification: Unclassified
Component: Devmanual (show other bugs)
Hardware: All Linux
: Normal normal (vote)
Assignee: Gentoo Devmanual Team
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2018-02-20 17:15 UTC by Michał Górny
Modified: 2020-01-25 06:02 UTC (History)
0 users

See Also:
Package list:
Runtime testing required: ---


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Michał Górny archtester Gentoo Infrastructure gentoo-dev Security 2018-02-20 17:15:54 UTC
I wanted to update the docs on keywording but they're not only a mess but actually two split messes that are partially duplicated and partially contradict each other.

https://devmanual.gentoo.org/keywording/index.html
https://devmanual.gentoo.org/ebuild-maintenance/maintenance-tasks/index.html

Would be nice to decide where we want stuff, put it in one place and remove the other. Then I can look into updating it.
Comment 1 Ulrich Müller gentoo-dev 2018-02-20 17:27:10 UTC
This should be definitely in Keywording.

Ebuild maintenance was part of the devrel handbook and later incorporated into the devmanual. Apparently not all duplications were cleaned up.
Comment 2 Ulrich Müller gentoo-dev 2020-01-23 13:27:11 UTC
After maintenance-tasks has been split, the duplication is now between:
https://devmanual.gentoo.org/keywording/index.html
https://devmanual.gentoo.org/ebuild-maintenance/stabilization/index.html

(In reply to Ulrich Müller from comment #1)
> This should be definitely in Keywording.

... still true.
Comment 3 Larry the Git Cow gentoo-dev 2020-01-25 06:02:06 UTC
The bug has been closed via the following commit(s):

https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=449da7f72272a7f3c4b5c5a2761151fc553d7338

commit 449da7f72272a7f3c4b5c5a2761151fc553d7338
Author:     Ulrich Müller <ulm@gentoo.org>
AuthorDate: 2020-01-23 16:54:18 +0000
Commit:     Ulrich Müller <ulm@gentoo.org>
CommitDate: 2020-01-25 05:53:21 +0000

    keywording: Include sections about stabilization.
    
    Remove the ebuild-maintenance/stabilization section (which resulted
    from the split of ebuild-maintenance/maintenance-tasks), and include
    it in keywording. Delete duplicate and outdated information.
    
    Closes: https://bugs.gentoo.org/648316
    Signed-off-by: Ulrich Müller <ulm@gentoo.org>

 ebuild-maintenance/stabilization/text.xml | 119 ------------------------------
 ebuild-maintenance/text.xml               |   1 -
 keywording/text.xml                       |  83 +++++++++++++++++----
 3 files changed, 69 insertions(+), 134 deletions(-)