Gentoo Archives: gentoo-doc

From: Sven Vermeulen <swift@g.o>
To: gentoo-doc@l.g.o
Subject: Re: [gentoo-doc] [RFC] Marking unmaintained documents
Date: Fri, 09 Sep 2005 19:51:46
In Reply to: Re: [gentoo-doc] [RFC] Marking unmaintained documents by "Jan Kundrát"
On Thu, Sep 08, 2005 at 08:12:08PM +0200, Jan Kundrát wrote:
> I'm not familiar with inner workings of gorg/axkit and I don't know > anything about speed issues or expensiveness of XML transformations, sorry.
Now that's an interesting subject for documents: performance analysis on Gentoo :) Would actually constitute an entire category of documents ! =)
> > If we mark some files as unmaintained, we're also telling our users that > > non-marked files *are* maintained. > > Good point, but IMHO we are now telling that *everything* is maintained > ("file is on -> it's official").
We are now telling that the documents on the site are up for improvements. Think about what we do with bugreports about /proj/en/* documents - we tell them the GDP can't fix those and redirect them to the appropriate team. What would you do with a bugreport about a totally different site? Right, giggle a bit, tell the world about the stupid bug report and mark it as wontfix/cantfix. Now what would you do with a bugreport about a document that /is/ in /doc/en? You'll either try to fix the document, or keep the bugreport until someone else can fix it. What's wrong with this? In the worst case, the bugreports for a particular guide are piling up with the net end result that we remove the document from CVS (well, Attic it or move it somewhere else). If we would mark documents as "outdated"/"unmaintained" and you'll get a bugreport about those, what would you do differently from bugreports on documents that are up-to-date/maintained? I would be quite surprised if you handled those bugs differently.
> That's why I included "[RFC]" in the subject. I don't know if it is > possible and worth the effort, I'm just asking.
I like it. Gives some action on the mailinglist again. I almost thought I would lose my English skills if it went on like this (no IRC, no English phone calls, hardly any mailinglist traffic - except on stupid or off-topic ... err ... topics :) Wkr, Sven Vermeulen -- Gentoo Foundation Trustee | Gentoo Documentation Project Lead | Gentoo Council Member The Gentoo Project <<< >>>


Subject Author
Re: [gentoo-doc] [RFC] Marking unmaintained documents "Jan Kundrát" <jkt@g.o>