[documentation] How to get more people involved with documentation

Luiz lz_listas at yahoo.com.br
Mon Jun 19 03:29:40 UTC 2006


I am seeing many efforts from you to improve of the documentation.

It's very good, but in my humble opinion the book page is the wrong 
"fundation". Many peoples already said the same.

You are trying to reform a great building which have sixty floors, but 
the foundation only can "manage" 2 floors.

My experience is the following: in our intranet I put internal 
procedures on books pages. There are four basic "blocks" and ten pages 
in each them, but the peoples are not feeling pleasure with that 
structure. In my case there are few pages and is not good, so you 
imagine Drupal.org there are much more.

If you have observed messages on forums, the peoples still ask simple 
questions that are on handbooks, in spite of improve in searching with 
4.7 version. For me it's significative there is some wrong with 
Handbooks, and it is not with content, but with the navegability of 
them.

It's perceptive books pages are not the best solution to manage big 
volumes of documentation. It's perceptive left menu with titles from 
subjects are bads to navegability.

In suma, the books pages are monolitic, hard to managing news pages and 
hard to maintenance them.

I think it's necessary to think other solution to the Handbooks.

Best wishes

Luiz

		
_______________________________________________________ 
Yahoo! Acesso Grátis - Internet rápida e grátis. Instale 
o discador agora! 
http://br.acesso.yahoo.com


More information about the documentation mailing list