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