Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 684350 - Remove empty TODO pages
Summary: Remove empty TODO pages
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: PATCH
Depends on:
Blocks:
 
Reported: 2019-04-25 17:33 UTC by Michael Orlitzky
Modified: 2019-09-06 09:41 UTC (History)
0 users

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


Attachments
0001-Remove-empty-TODO-pages.patch (0001-Remove-empty-TODO-pages.patch,5.97 KB, patch)
2019-04-25 17:34 UTC, Michael Orlitzky
Details | Diff
0001-Remove-empty-TODO-pages.patch (0001-Remove-empty-TODO-pages.patch,8.33 KB, patch)
2019-04-25 17:47 UTC, Michael Orlitzky
Details | Diff

Note You need to log in before you can comment on or make changes to this bug.
Description Michael Orlitzky gentoo-dev 2019-04-25 17:33:56 UTC
There are a number of pages in the devmanual that contain only a "TODO: write me later." This looks half-assed, and we have better ways (e.g. bugzilla) to track future tasks.
Comment 1 Michael Orlitzky gentoo-dev 2019-04-25 17:34:52 UTC
Created attachment 574112 [details, diff]
0001-Remove-empty-TODO-pages.patch
Comment 2 Michael Orlitzky gentoo-dev 2019-04-25 17:47:34 UTC
Created attachment 574114 [details, diff]
0001-Remove-empty-TODO-pages.patch

v2: forgot to remove those pages from the table of contents.
Comment 3 Michael Orlitzky gentoo-dev 2019-09-05 22:49:37 UTC
Ping, this one's real easy.
Comment 4 Larry the Git Cow gentoo-dev 2019-09-06 09:41:24 UTC
The bug has been closed via the following commit(s):

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

commit f9567de4159240d7c3074f78301fe0d6a65ee25f
Author:     Michael Orlitzky <mjo@gentoo.org>
AuthorDate: 2019-04-25 17:25:50 +0000
Commit:     Ulrich Müller <ulm@gentoo.org>
CommitDate: 2019-09-06 09:40:50 +0000

    Remove empty TODO pages.
    
    The following pages were devoid of any real information, containing
    only a note to "write me in the future,"
    
      * ebuild-writing/functions/src_unpack/deb-sources
      * ebuild-writing/functions/src_unpack/tla-sources
      * general-concepts/distributed-building
      * general-concepts/linguas
      * general-concepts/privileges
      * profiles/profiles.desc
      * tasks-reference/perl-modules
    
    That isn't helpful to the reader, and just plain looks bad. This
    commit removes them all.
    
    Closes: https://bugs.gentoo.org/684350
    Signed-off-by: Michael Orlitzky <mjo@gentoo.org>
    Signed-off-by: Ulrich Müller <ulm@gentoo.org>

 .../functions/src_unpack/deb-sources/text.xml         | 12 ------------
 ebuild-writing/functions/src_unpack/text.xml          |  2 --
 .../functions/src_unpack/tla-sources/text.xml         | 12 ------------
 general-concepts/distributed-building/text.xml        | 13 -------------
 general-concepts/linguas/text.xml                     | 13 -------------
 general-concepts/privileges/text.xml                  | 15 ---------------
 general-concepts/text.xml                             |  3 ---
 profiles/profiles.desc/text.xml                       | 14 --------------
 profiles/text.xml                                     |  1 -
 tasks-reference/perl-modules/text.xml                 | 19 -------------------
 tasks-reference/text.xml                              |  1 -
 11 files changed, 105 deletions(-)