[drupal-docs] Doc forum, "best practices", etc.

Boris Mann borismann at gmail.com
Sun Apr 10 00:02:20 UTC 2005


I want to direct everyone's attention to the Documentation forum --
http://drupal.org/forum/33. This is our on-Drupal.org spot for
discussing things.

Carlo (a new member on this list and to Drupal -- welcome and thank
you!) wrote a post (http://drupal.org/node/20173) asking about process
for having book pages approved. This is, of course, the difficulty in
not having notification of new book pages/pages in the queue.

Also, while Carlo's has done a good write up, the tone and material is
not (IMHO) correct for documentation -- it's more of a "best
practices" document as we have been doing on our support site. For
those that don't have permission to view the node on Drupal.org, I've
pasted the content into the dev wiki here:
http://dev.bryght.com/t/wiki/DrupalGeneralConcepts

What do people think about "best practices" style articles? I think
this is very good information to have, especially when you could have
multiple "best practices" written for different situations or
viewpoints, but that it shouldn't be part of the main tree of
documentation. For Carlo's article, I would say that the audience
would be Site Admins, and the topic would be Site Setup and/or General
Concepts. We can quickly see some category terms emerging here.

Anyway, just wanted to throw that out there and make sure people know
I'm still thinking about all this.

--
Boris Mann
http://www.bryght.com



More information about the drupal-docs mailing list