Welcome to the "ubuntu-doc" mailing list

Geert Poels geert.poels at skynet.be
Sun Mar 11 14:04:42 UTC 2007


Mr bodhi.zazen,

I'm really for some action taken towards not only beginners, but a lot 
of users.
The forums get a lot of the same questions which should the docs should 
answer.
A lot of freshmens have had some kind of hardware issue.
Our hardware doc pages should be updated with each of them.

The process requires two things :
- Create user awareness about the docs&wiki and the possibility to 
update these.
- Follow-up of suggestions and questions in the forums by the doc 
maintainers and take appropriate action.

IMHO :
No issue posted on a mailing list or forum should go unnoticed nor 
unhandled.
Errors should be fixed, documentation should be expanded or clarified, 
the software enhanced.
The only way to fully achieve this, is to have reponsable people in 
place and ... work with a ticketing system.
If an issue is recognised and accepted as 'something to improve', some
person/'department' should get a ticket :
fix bug, enhance wiki, enhance docs, ... whatever.
This will generate some overhead and tons of work in the beginning, to
phase out and stabilize soon after.

I know, this is Utopia.
But I strongly believe in the idea.
A user will not ask for help when software is allright and documentation 
clear, up to date and complete.
Most key issues of a distro will not or only slowly evolve, so not much 
ongoing work there.
Once established, it's there for a very long time.

Finally, just take a look at the work good people have done in the 
'Tutorials & Tips' page :
http://www.ubuntuforums.org/forumdisplay.php?f=100
When accepted and verified, this stuff should go straight in the docs/wiki.
Next, 'hire' them.
Maybe they have other good ideas and docs.
Ask them to spot others.
Build an army  ;-)

Geert




More information about the ubuntu-doc mailing list