[drupal-docs] Drupal documentation organizing experiment-lastdraft

[Ron Mahon]

 Logically there is no difference between a core module and a contrib.Module
Ron


InterNet Marketing Resource Center
A Free Super Mart of Articles, Demos, Tutorials everything you need to
Succeed on the net.
www.inmrc.com 


-----Original Message-----
From: Boris Mann [mailto:boris at bryght.com] 
Sent: Friday, April 29, 2005 3:09 AM
To: drupal-docs at drupal.org
Subject: Re: [drupal-docs] Drupal documentation organizing
experiment-lastdraft


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