Multiple Ubuntu releases - representing them on the wiki

Matthew Paul Thomas mpt at myrealbox.com
Wed Feb 1 21:59:19 UTC 2006


On 1 Feb, 2006, at 9:51 PM, Naaman Campbell wrote:
> ...
> At present, the Wiki, in general, is current for the current release -
> Breezy Badger.  This is something I would like to address at a future
> documentation team, what is the strategy for Wiki docs

This discussion is familiar to me. :-)  
<http://comox.textdrive.com/pipermail/wp-docs/2005-February/ 
000038.html> My suggestion is the same here:
*   add version-specific sections to pages where necessary
*   add "Applies to" (and, if necessary, "Does not apply to") sections
     to other pages.

For example:

     == Applies to: ==
      * Ubuntu 5.04
     == Does not apply to: ==
      * Ubuntu 5.10 and later

> - my suggestions are to explicitly state that a certain procedure is  
> for an older release and assume everything else is for the current  
> release,
> ...

That won't work unless, on release day, someone updates *every* help  
page on the wiki to indicate whether it still applies to the current  
release. I doubt anyone has time to do that. (And some people reading a  
wiki page might not even be aware that their release is no longer  
current!) I think using "Applies to" and "Does not apply to" sections  
is the only solution that can produce a reliable result with volunteers  
updating pages over time.

-- 
Matthew Paul Thomas
http://mpt.net.nz/





More information about the ubuntu-doc mailing list