<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>