[drupal-docs] Usability experiment for Drupal documentation-please review

[Kieran Lal]

uggh, there's no flash for linux?
http://freshmeat.net/projects/f4l/

Do it manually, and I'll ask the folks to import your results if it's 
possible.  Sorry for the hassle.

Follow these directions:
Introduction:
We are conducting research that will help us gain a better 
understanding of how Drupal Documentation should be organized and make 
it easier to use.

Instructions:
Assign each of the items in the list on the left to one of the category 
boxes on the right.  The items are names of documentation that have 
been suggested by the community.  Some documents may seem similar 
because different people suggested the titles.  However, they may in 
fact be different.

Just drag items from the list into folders. What items belong together? 
Think of a grocery store -- milk, cheese and butter are in the Dairy 
section and apples and oranges are in the Fruit section.

There is no right group for the items.  If you can not decide which 
group a document belongs in you can place it in the Don't know/Don't 
understand group.

This exercise should take you 20 to 30 minutes. You must do the 
exercise in one sitting.

Useful definitions:
Drupal(CivicSpace, Bryght) is a dynamic web site platform which allows 
an individual or community of users to publish, manage and organize a 
variety of content, Drupal integrates many popular features of content 
management systems, weblogs, collaborative tools and discussion-based 
community software into one easy-to-use package.

Drupal handbooks are the terms used for books of Drupal documentation.

Modules/Applications: modules refer to the individual programs that run 
on Drupal.  People unfamiliar to Drupal think of these as applications.

Developing: is the term used for programming, desiging, testing, and 
documenting.

Administering: Means configurating the application as it is.  There are 
no fundamental changes to the underlying the Drupal platform  This is 
mostly done through administration of the system through web 
interfaces.

Theme: Modifies the look and presentation of your site

Please feel free to leave comments.  Thank you for taking the time to 
participate in our study.


Sort the list below into this list:
About Drupal
Installation and upgrading
Configuration and customization
Developing for Drupal
About the handbook
Docs in progress(wiki)
Don't know/Don't understand

Drupal, CivicSpace, Bryght comparison chart
OS, DB, PHP, Webserver level docs
OS, DB, PHP, Webserver 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
Block tutorial
What are the core applications?
What do the core applications do?
Configuring core applications
Installing new applications
Application overviews
How theme engines work
How a theme affects your site
Trouble shooting guide
Development on Drupal
Learning how Drupal is put together?
How to make blocks
How to make modules
Marketing
User experience and usability guide
Security
Performance
Testing
Core concepts
Example site walkthroughs
Theme developers guide
Handbook for using applications(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
Taxonomy tutorial
Language translator guide
Advanced module development tutorial
Guide to combining modules
What can I do with Drupal?
How does Drupal work?


On Apr 29, 2005, at 6:21 PM, grohk wrote:

> -----BEGIN PGP SIGNED MESSAGE-----
> Hash: SHA1
>
> Kieran Lal wrote:
>> 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.
>
> Hello, list.  Long time lurker, first time poster.  Just wanted to let
> you know that this site is not accessible using OSes like Linux on 
> archs
> other than x86 because of the dependency on the non-free flash plug-in
> (no source, no compile to alternative archs).  I would like to
> participate in this discussion...any way around this?
>
> Thanks,
> Brady Jarvis
> -----BEGIN PGP SIGNATURE-----
> Version: GnuPG v1.4.0 (GNU/Linux)
> Comment: Using GnuPG with Thunderbird - http://enigmail.mozdev.org
>
> iD8DBQFCct2vO+lwfsap+f0RAqULAJ9mGvi4DcrfOsCGg0GJwl6aAn+LVACghteS
> kvZDzy0tjeHZ+p+q9V5fEJY=
> =I6eB
> -----END PGP SIGNATURE-----
> -- 
> [ drupal-docs | http://lists.drupal.org/listinfo/drupal-docs ]