[drupal-docs] Usability experiment for Drupal documentation-pleasereview

[Ron Mahon]

I agree with most of what's being proposed but nothing beats action. It also
points out the flaws in design. I will have more to say about this shortly. 

In the mean time I have reverted to a old structured design mythology. This
will Allow us to look at the structure of the documents with out worrying
about how and what. It will also show us the depth. And whether it is
possible to meat the depth requirements.

The layout look is here http://tech-mall.com/drupal/?q=drupal-docs at the
test site.
You can right click on the screen shots and steal them.

Ron

PS:I have not included all the features of this tool, because it did not
seam necessary.
Should any one be interested you can read more about it here
http://www.kenorrinst.com/wo1.html




-----Original Message-----
From: Kieran Lal [mailto:kieran at civicspacelabs.org] 
Sent: Wednesday, April 27, 2005 10:23 PM
To: drupal-docs at drupal.org
Subject: [drupal-docs] Usability experiment for Drupal
documentation-pleasereview

Hi, the usability experiment I will be conducting will help us to identify
how users think the documentation should be grouped.

You can see the experiment here: 
http://www.websort.net/dev/sort.php?studyname=drupaldocumentation.  
Sign in with the name test if you want to check it out.

The latest thread has us down to 5 categories:
-Getting Started and Using a Drupal Website -Administering a Drupal Website
-Developing for Drupal -About Drupal -About the Handbook I am going to
suggest we add the Wiki as a major documentation group based on feedback
from the survey.

I have a list of 61 items which I believe is too long, but is based on
feedback that I have gotten in two rounds of user interviews and mining 
the drupal-docs list.   I would appreciate it if someone would help 
review it to narrow the number of items they think are redundant, but still
reflect the needs of users.  If the experiment is good for users then I will
launch it.

Cheers,
Kieran

List of document instances to be sorted.

Event tutorial
General info
Drupal Distribution comparison chart
system-level docs
system level tasks needed to install
System Requirements
Installation Process
Installation best practices
Core vs contributed applications/modules How to install a contributed module
How to upgrade Drupal core.
How to upgrade Drupal with modules and themes.
How to back up a site
How to restore a site
How to move a site
What settings are where
Initial configuration
Advanced configuration
Blocks
What are the core applications?
What do the core applications do?
Configuring core applications
Installing new applications
Description of contributed applications
Core theme documentation
Explanation on theme engines
Installing a new theme
How a theme affects your site
Making a new theme
Trouble shooting guide
Trouble shooting FAQ
Development on Drupal
Learning how Drupal is put together?
How to make blocks
How to make modules
How to make themes
Translator
Marketing
User Experience, usability, user testing Security Performance Testing Drupal
core concepts Drupal walkthroughs Theme developers guide Handbook for using
application(module) Common tasks Beginner tutorials Data relationship
diagram Step by step page view generation Module dev troubleshooting guide
Theme tutorial Architecture overview Walkthrough of example sites Flash
tutorials Taxonomy tutorial Translator guide Advanced module development
tutorial Guide to combining modules What can I do with Drupal?
How does Drupal work?