[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