<html>
<head>
<meta content="text/html; charset=ISO-8859-1"
http-equiv="Content-Type">
</head>
<body bgcolor="#FFFFFF" text="#000000">
<div class="moz-cite-prefix"><br>
All,<br>
<br>
On 08-12-13 10:58, Hannie Dumoleyn wrote:<br>
</div>
<blockquote cite="mid:52A442C7.6060808@zonnet.nl" type="cite">
<meta content="text/html; charset=ISO-8859-1"
http-equiv="Content-Type">
<div class="moz-cite-prefix">Here are some of my thoughts, for
what they are worth (maybe it is not feasible). <br>
<br>
I agree that it is better if a wiki page is written in such a
way that it can be used in all versions. Unfortunately, that is
not always possible. Here are some ideas I have on this:<br>
1. Guidelines for wiki page writers: try to make it as generic
as possible/avoid mentioning version number unless the contents
is specifically meant for that version/other advice?<br>
2. Tagging: Add a selection box with version numbers to all new
wiki pages where the default is "All versions". The writer can
choose another version number here, but only if the page is
written for that version only.<br>
3. Check wiki pages on a regular basis to see if the contents is
still valid for "All versions". This is the most difficult and
time consuming task which could be done by community wiki team
members. Perhaps the bulk of wiki pages can be divided in
smaller portions (subjects, alphabetically, categories?) so that
team members can check a certain number of subjects/pages.<br>
</div>
</blockquote>
<br>
I agree with most of it. Although I wouldn't write guides for Ubuntu
versions, write them for the package version. If a major release of
a certain package breaks the docs, you need to change it. Minor
releases are often backwards compatible. So your docs are safe. In
case a major release is done, you need to update the docs (only for
that specific release/version). You can have a main page eg. <br>
<br>
OpenSSHD:<br>
A lot of nifty details regarding OpenSSH and its daemon and
client.<br>
You can even talk about details for a specific version and refer
to the subpage.<br>
<br>
OpenSSHD/Version_X.y:<br>
a sub page describing the details with specific details for
that release<br>
<br>
OpenSSHD/Version_Y.z<br>
a sub page describing the details with specific details for
that release<br>
<br>
Perhaps prior to an Ubuntu release (when the alpha does live or pick
any date) a script checks all the tags on a page (version of the
package/Ubuntu) and can notify the doc team about issues. I don't
think a human should check all the pages, that can be automated. You
can also check if pages do not have a tag and notify the doc-team so
these pages can be tagged.<br>
I think that will decrease the workload of having to check pages.<br>
<br>
Cheers,<br>
Wesley<br>
</body>
</html>