I have started a big, systematic pass through the doc (primarily live-manual, but we will correct any man pages that need work as we go) to bring it up to date for 3.x. I expect this to take a few months.
Here's an outline of what I would like us to accomplish by the end of January, in rough order of execution: 1. Get all the Examples working (test each one using 3.0~a38-1, or whatever is latest). 2. Fix up related areas of doc*** as we work on each change to keep the doc as consistent as possible. (This step is to be done concurrently with step 1.) 3. Go back over the remaining doc, filling in the holes not covered in Examples (noting at the same time any new Examples that may be needed to cover that material, but not acting on it yet). As with step 1, make sure every code example in the doc works by testing it. 4. Begin adding new material for new topics in 3.x (e.g. derivatives). 5. Address deficiencies in doc present ever since 2.x (e.g. more examples using config/*/ subdirs, plus discussions in the main body of the manual to cover those). It's November now. I would like to at least reach the beginning of point 5 by Christmas. If you're interested in making a contribution to the documentation, are skilled in doc writing, can work fairly independently on it, but also work well in a team, I would be interested to hear from you either here or on irc. Ben (SynrG on irc). *** e.g. As I worked through the preamble in the Examples section, the first thing I spotted was that references to LB_MIRROR_* variables should be changed to LB_PARENT_MIRROR_* variables, and the corresponding option names throughout the manual, as the old variable and option names are now for derivatives of the parent, which is not the "normal" case for a new user. See: http://live.debian.net/gitweb?p=live-manual.git;a=commit;h=dad70b96504cc94f295e69896ee4eedf02a7021a -- To UNSUBSCRIBE, email to [email protected] with a subject of "unsubscribe". Trouble? Contact [email protected] Archive: http://lists.debian.org/[email protected]
