Gentoo Logo
Gentoo Spaceship

Installation:
Gentoo Handbook
Installation Docs

Documentation:
Home
Listing
About Gentoo
Philosophy
Social Contract

Resources:
Bug Tracker
Developer List
Discussion Forums
Gentoo BitTorrents
Gentoo Linux Enhancement Proposals
IRC Channels
Mailing Lists
Mirrors
Name and Logo Guidelines
Online Package Database
Security Announcements
Staffing Needs
Supporting Vendors
View our CVS

Graphics:
Logos and themes
Icons
ScreenShots

Miscellaneous Resources:
Gentoo Linux Store
Gentoo-hosted projects
IBM dW/Intel article archive




List Archive: gentoo-doc
Navigation:
Lists: gentoo-doc: < Prev By Thread Next > < Prev By Date Next >
Headers:
To: gentoo-doc@g.o
From: Josh Saddler <nightmorph@g.o>
Subject: Re: Removing obsolete guides
Date: Mon, 16 Jul 2007 00:56:04 -0700

 1.1

Xavier Neys wrote:
> Josh Saddler wrote:
>> I'd like to remove the obsolete guides in /doc/en/. They're all properly
>> marked with disclaimer="obsolete", and with the exception of
>> nx-guide.xml, none of them appear in list.xml. They don't work anymore
>> and have no business cluttering up our tree. Redirects are pointless too
>> for these old docs, as any links that may have existed to them elsewhere
>> on the net are years out of date.
>>
>> Any objections?
> 
> You forgot to list the files you want to remove.
> 
> $ grep -e 'disclaimer="obsolete' *xml|grep -v redirect|cut -d: -f1|cat -b
>      1  colinux-howto.xml
>      2  ldap-howto.xml
>      3  management-structure.xml
>      4  nx-guide.xml

Ah, so I did, thanks for the list.

> 
> 1 looks dead to me.

Yup, I'll kill this one.

> 2 has two bugs assigned to it, one being a blocker, the doc is not listed in
> the index

I'm currently trying to drum up interest in it among the devs who are
more knowledgable about it. Give it one last shot (or maybe two) before
killing it.

> 3:
> """<impo>
> <brite>As of May 2005, this document is no longer valid but kept for historical
> purposes.</brite>
> </impo>
> """
> should be clear enough

I think the "historical purposes" bit isn't valid anymore -- CVS is our
history, and we have many more docs that were removed but are still
available. CVS is forever! We should just use that and nuke the file.

> 4 has been useless since day 1

I agree wholeheartedly.

For now, I'll kill off 1 and 4. Thanks for your thoughts, keep 'em coming.


Attachment:
signature.asc (OpenPGP digital signature)
References:
Removing obsolete guides
-- Josh Saddler
Re: Removing obsolete guides
-- Xavier Neys
Navigation:
Lists: gentoo-doc: < Prev By Thread Next > < Prev By Date Next >
Previous by thread:
Re: Removing obsolete guides
Next by thread:
Re: Removing obsolete guides
Previous by date:
Re: Removing obsolete guides
Next by date:
Re: Removing obsolete guides


May 29, 2008

Donate to support our development efforts.

Gentoo Centric Hosting: vr.org

VR Hosted

Tek Alchemy

Tek Alchemy

SevenL.net

SevenL.net

php|architect

php|architect

Copyright 2001-2007 Gentoo Foundation, Inc. Questions, Comments? Email www@gentoo.org.