Proposal: Useful Documentation Round-up
John Levin
john at technolalia.org
Tue Feb 1 17:01:51 UTC 2005
Hi all,
First off, I don't have a great deal of time to devote to the doc
project, especially as I'm involved in starting up the Ubuntu GB
community. I'll still be subscribed to this list, and will stick my oar
in whenever; I also hope (still!) to find time for Ubuntu ppc
documentation.
There is another reason for my limited participation in documenting -
wondering about the fundamentals of documentation, what to do and how
to do it, and what's wrong with the present state of docs (one of the
most frequent complaints made of Linux).
To this end, I'd like to make a proposal - a quick, simple but fruitful
project that I would take responsibility for: The Useful Documentation
Round-Up
There is a large and ever-increasing quantity of documentation on the
web. Sites such as Newsforge (http://www.newsforge.com/) publish two or
three articles every day. New ventures are starting all the time (for
example, http://gnomejournal.org/ has just published its second issue.)
The problem is locating the good, up-to-date and relevant material, and
conversely, weeding out the ill-written and out-of-date.
The ubuntu wiki page
https://www.ubuntulinux.org/wiki/UsefulDocumentation gives only a few
of the many useful sites, concentrates on generalities rather than
specifics, and hasn't been updated for three months.
So what I envisage is a regular email bulletin (once or twice a month)
giving links to useful, recently (web-)published documentation. It
could also give a round up of new ubuntu docs and wikipages. Back
issues can be archived, as Ubuntu Traffic is, and the wiki page more
easily maintained and kept up to date.
This will also help Ubuntu-native documentation in giving a base to
work from, documents that can be 'ubuntu-ized' (licenses permitting),
and a general sense of the state of linux documentation.
What think you all?
John
More information about the ubuntu-doc
mailing list