Gentoo Archives: gentoo-doc

From: Josh Saddler <nightmorph@g.o>
To: gentoo-doc@l.g.o
Subject: Re: [gentoo-doc] Removing obsolete guides
Date: Mon, 16 Jul 2007 07:56:41
Message-Id: 469B2494.9070402@gentoo.org
In Reply to: Re: [gentoo-doc] Removing obsolete guides by Xavier Neys
1 Xavier Neys wrote:
2 > Josh Saddler wrote:
3 >> I'd like to remove the obsolete guides in /doc/en/. They're all properly
4 >> marked with disclaimer="obsolete", and with the exception of
5 >> nx-guide.xml, none of them appear in list.xml. They don't work anymore
6 >> and have no business cluttering up our tree. Redirects are pointless too
7 >> for these old docs, as any links that may have existed to them elsewhere
8 >> on the net are years out of date.
9 >>
10 >> Any objections?
11 >
12 > You forgot to list the files you want to remove.
13 >
14 > $ grep -e 'disclaimer="obsolete' *xml|grep -v redirect|cut -d: -f1|cat -b
15 > 1 colinux-howto.xml
16 > 2 ldap-howto.xml
17 > 3 management-structure.xml
18 > 4 nx-guide.xml
19
20 Ah, so I did, thanks for the list.
21
22 >
23 > 1 looks dead to me.
24
25 Yup, I'll kill this one.
26
27 > 2 has two bugs assigned to it, one being a blocker, the doc is not listed in
28 > the index
29
30 I'm currently trying to drum up interest in it among the devs who are
31 more knowledgable about it. Give it one last shot (or maybe two) before
32 killing it.
33
34 > 3:
35 > """<impo>
36 > <brite>As of May 2005, this document is no longer valid but kept for historical
37 > purposes.</brite>
38 > </impo>
39 > """
40 > should be clear enough
41
42 I think the "historical purposes" bit isn't valid anymore -- CVS is our
43 history, and we have many more docs that were removed but are still
44 available. CVS is forever! We should just use that and nuke the file.
45
46 > 4 has been useless since day 1
47
48 I agree wholeheartedly.
49
50 For now, I'll kill off 1 and 4. Thanks for your thoughts, keep 'em coming.

Attachments

File name MIME type
signature.asc application/pgp-signature