Gentoo Logo
Gentoo Spaceship

Note: Due to technical difficulties, the Archives are currently not up to date. GMANE provides an alternative service for most mailing lists.
c.f. bug 424647
List Archive: gentoo-doc
Lists: gentoo-doc: < Prev By Thread Next > < Prev By Date Next >
To: gentoo-doc@g.o
From: Jan Kundrát <jkt@g.o>
Subject: Re: [RFC] Marking unmaintained documents
Date: Sat, 10 Sep 2005 14:35:09 +0200
Sven Vermeulen wrote:
>>a) Third party article
> We "can" fix those, but you don't see any news site "fix" their news items
> after a year... they are kept online as a reference. You might want to write
> a new article about the same subject but more accurate - having the old
> article at your disposal can be very interesting.

Well, I'm not talking about fixing, but marking *third-party* articles
as such.

> Although I can see why you want the chapters of the older handbooks "marked"
> as out-dated, some people still use the older handbooks, especially if they
> have older release media and want a networkless installation.
> But then again, that's not the point :) Personally, I don't think we need
> anything red on those handbooks - I would refer to the people's common sense
> when they are reading the 2004.3 handbook :)

Okay, you've persuaded me :-).

>>c) Translation in language which is not officially supported
> We don't link that language; the documents are made available if you know
> the URI (which is of course not difficult to grasp). Perhaps we can disable
> viewing it entirely unless some variable is set (?override=1) but I don't
> think we should.

Neither do I. And yes, you (well, actually someone else, probably rane
or flammie) are right, additional warning might scare users so they
won't trust the translation which is very bad for the first stage of the

> Yes, I know you want something to tell the users "Beware, this document
> might contain wrong information" but then again, how would you know the
> document gives wrong directives to the user? An old hardware-related guide
> might still be perfectly valid - just not updated. Or a very recent guide
> can contain erroneous commands while it is still actively maintained.

I haven't said old document is wrong document, of course not. I was
inspired by some bugreports touching articles.

> Imo, as long as there is no AI that can inform us about the malicious
> content of a document, we can't easily mark such documents as "outdated" or
> "erroneous". I have made a small attempt by allowing us to mark a specific
> bug as a showstopper in metadoc - as a result, the document will be unlinked
> from the index page. This can be extended by adding-in a <warn> on top of
> the document, but you'll have to fight Xavier with this as this results in
> another few queries of metadoc and such and makes the XSL again more
> obscure.

Yep, the question is if it is worth the effort. I'm inclining to say
"no", based on the arguments I've received (except for third-party
articles :-) ).


cd /local/pub && more beer > /dev/mouth
signature.asc (OpenPGP digital signature)
[RFC] Marking unmaintained documents
-- Jan Kundrát
Re: [RFC] Marking unmaintained documents
-- Sven Vermeulen
Lists: gentoo-doc: < Prev By Thread Next > < Prev By Date Next >
Previous by thread:
Re: [RFC] Marking unmaintained documents
Next by thread:
Re: [RFC] Marking unmaintained documents
Previous by date:
Re: [RFC] Marking unmaintained documents
Next by date:
Re: [RFC] Marking unmaintained documents

Updated Jun 17, 2009

Summary: Archive of the gentoo-doc mailing list.

Donate to support our development efforts.

Copyright 2001-2013 Gentoo Foundation, Inc. Questions, Comments? Contact us.