[drupal-docs] Drupal documentation organizing experiment-last draft

Boris Mann boris at bryght.com
Fri Apr 29 07:09:25 UTC 2005


On 28-Apr-05, at 11:30 PM, Kieran Lal wrote:

> The only remaining question is whether or not to add a separate
> handbook for applications(modules) given the strong requests for it
> based on the survey.

I believe that fits into the existing book:

Admin Guide (or Getting Started? my original guideline was if it needs 
a command line, it goes in Installation, Upgrades, and Maintenance, 
which has been renamed Getting Started....this is a friendly name, but 
has a lot of unfriendly, command line stuff in it; now I would almost 
put the scary stuff in Admin Guide)
- Core Modules
- Contrib Modules
-- organic groups
-- img_assist
-- etc.

Card sort looks *great*. I just fiddled for a bit, and yeah, I think we 
need more books. Actually, there is this whole other category (yup, I'm 
harping) that would be perfectly implemented as access to the "story" 
type and taxonomies -- e.g. guide to combining modules is not 
documentation, it is a best practices that could be written as 
contradictory/conflicting points of view by different people, but still 
be completely valid information. I'd love to have a place for this to 
live, but it is not documentation.

Dries: I haven't heard you comment, so I assume you are not in favour. 
How do you feel about implementing this type of "article" content on 
Drupal.org? Example taxonomy terms/types of content:
* Best Practices
* Case Studies
* Guides/Tutorials (e.g. Joe's Guide to Setting up an Airplane Club 
Website, Roland's PHPTemplate 101)
* News/Event Coverage

I'm supposed to be busy...

/me backs away from mailing list....

--
Boris Mann
http://www.bryght.com
Vancouver 778-896-2747 / San Francisco 415-367-3595
SKYPE borismann




More information about the drupal-docs mailing list