[documentation] Barriers to entry...

[Nancy Wichmann]

Shai Gluskin wrote:

> MS Office... probably the best built-in help system I've seen.

 

I sincerely hope we can do better than that. Personally, I think it has a
long way to go. But maybe that's because I am a long time power user, so
when I have a question, it's usually a doozy.

 

The best part of that to model is the task-oriented writing. Much of
Drupal's documentation is not task-oriented.

 

When I was working with IBM mainframes (long ago, in a galaxy far away) we
had a "User's Guide" and a "User's Reference" for most things. The Guide was
lower level, and mostly task oriented, while the Reference was
function-oriented, more like DO.

 

 

Nancy E. Wichmann, PMP 

Injustice anywhere is a threat to justice everywhere. -- Dr. Martin L. King,
Jr.

-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.drupal.org/pipermail/documentation/attachments/20091115/a948c215/attachment.html