discuss: Some of the main problems of the libre documentation
Subject:
Re: Some of the main problems of the libre documentation
From:
David Lawyer ####@####.####
Date:
19 Jun 2003 07:29:39 -0000
Message-Id: <20030619044137.GC414@lafn.org>
On Wed, Jun 18, 2003 at 11:54:40AM +1000, Mary Gardiner wrote:
> On Tue, Jun 17, 2003, Tabatha Marshall wrote:
> > I think that would help tremendously. We have had volunteers right
> > here in the discussion list on several occasions, but it's been on
> > somewhat of a transient basis so far.
> >
> > If I can help in any way, please let me know!
>
> Probably what I will do is this: when a call for reviewers goes out on
> the editors list, I will attempt, if possible, to locate the most
> relevant developer/user communities and send out a general call for
> volunteer technical reviewers. Should we get more than one, I'll also
> try to coordinate their share of the review.
It's equally important to review existing documentation. One job is to
establish rough review priorities for some of the existing
documentation. First should come all docs by Al Dev. But then after
that is underway?? One might look for docs on the same topic that need
merging. It's also desirable to split up the work and have many docs on
various aspects of the same topic when there is a feasible way to
establish boundary lines between documents. An example might be a
Printer-HOWTO and various mini-HOWTOs each on a different
brand/model/series of printer.
Also, one might look at the docs that haven't been updated in a long
time. Another check would be to find docs that have relatively short
diffs for updates done infrequently. This implies that they haven't
been changed much are are suspect for being out-of-date. This
frequently happens. The maintainer only corrects typos, etc. reported by
readers but fails to otherwise update the doc.
David Lawyer
