Wiki pages that apply to only one release

Rocco Stanzione grasshopper at linuxkungfu.org
Tue Jun 6 12:38:32 UTC 2006


On Tuesday 06 June 2006 2:11 am, Corey Burger wrote:
> There are a fair number of wiki pages that only apply to one release,
> mostly becuase they deal with a hardware issue that has been solved in
> a later release. After Warty EOLed, I went around and cleaned up
> reference to it from our docs. This was an annoying task, because I
> had to go and find each page. Therefor I would like to propose a
> process of tagging pages for releases. This does raise a number of
> issues:
>
> 1. Do we tag all pages or only pages that are for a specific release?

It will often be hard to tell if a page applies only to the current release, 
unless it addresses an issue that's already been dealt with.  For example, 
the pages cropping up right now may address Dapper issues that will no longer 
exist in Edgy, but for the most part we can't know that yet.  I think it 
makes sense, then, to tag all pages, or all pages that are Ubuntu-specific.

> 2. Do we use the name or the number of the release (Hoary vs 5.04) in
> the category name

On IRC, in the forums, and on the wiki, I've noticed that users seem to refer 
to releases by name far more often than version number.  I do the same 
myself.  I also remember the name Warty but not its version number.  Unless 
this observation is way off, let's go with release names - it also avoids 
dealing with dots in the category name.

> 3. Do we all agree that removing docs for non-security supported
> releases is a good thing?

I usually find that moving things out of the way proves to be a better idea 
than deleting them, unless the problem I'm solving is a disk space issue.  
There can still be valuable information in documents whose purpose is to 
solve an issue that no longer exists: the discussion of the issue can help me 
learn something important about whatever had the problem.  Search engines can 
take a long time to remove links to the deleted pages.  Is it possible to 
create an "Archived" supercategory and keep it accessible without having it 
in the way?

> 4. Any other issues I forgot about?

Off the top of my head, no.

Thanks,

Rocco Stanzione




More information about the ubuntu-doc mailing list