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

Dries Buytaert dries at buytaert.net
Fri Apr 29 09:08:42 UTC 2005


On 29 Apr 2005, at 08:30, Kieran Lal wrote:

> Hi, I want to thank Ron, Denise, Furilo, and Heather for taking the
> time to fill out the card sorting experiment.  Your feedback helped me
> eliminate several documentation descriptions that were repetitive.  I
> have also added descriptions of terms that we in the Drupal community
> take for granted.  I also want to thank the 147 and counting people
> that took the time to fill out the Drupal Documentation survey.
>
> http://www.websort.net/dev/sort.php?studyname=drupaldocumentation
>
> 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.  If I don't get anymore comments then I will
> launch the experiment some time late tomorrow.

The cardsort exercise is really interesting.  To me, the boundary or 
separation between 'getting started' and 'administration' was pretty 
blurry.  There is quite some overlap between both to the point I almost 
gave up because I couldn't come up with a consistent classification.  
Like, is 'block tutorial' a 'getting started' thing or an 
'administration' thing?  At what point, 'getting started' stops and 
'administration' begins?  It is not clear at all.

After doing the cardsort exercise, I think the following would work 
better:

   - About Drupal
   - Installation and upgrading
   - Configuration and customization
   - Developing for Drupal
   - About the handbook

Is is more task-oriented, which really helps.

--
Dries Buytaert  ::  http://www.buytaert.net/




More information about the drupal-docs mailing list