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

[Kieran Lal]

Ron,
	that looks great.  Hopefully, the feedback from the experiment will 
help provide some insight into how people think the documentation 
should be organized and we can respond accordingly.

There are a number of tools that are used to visually explain 
information architecture.  If someone wanted to help make it look even 
better you can get tools here: http://iabook.com/template.htm

Cheers,
Kieran

On Apr 28, 2005, at 12:54 PM, Ron Mahon wrote:

> 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?
>
>
>
> -- 
> [ drupal-docs | http://lists.drupal.org/listinfo/drupal-docs ]