[documentation] The handbook organization

Kieran Lal kieran at civicspacelabs.org
Wed Aug 30 18:33:29 UTC 2006


On Aug 30, 2006, at 7:50 AM, Greg Knaddison - GVS wrote:

> I recently discussed "drupal vs. joomla" with someone who was new to
> the whole concept of CMS.  His comment was basically "well, I looked
> at the two communities and while everything I read said that Drupal
> was better and while Joomla occasionally meant I had to pay to get
> stuff, I started using Joomla because the tutorials/videos/etc. made
> it easier for me to get down to business."

Anecdotal evidence is good.  But I want it to be balanced with  
passive analysis like I have indicated before as well as direct  
audience analysis.

I am skeptical that with tutorials featured more prominently things  
will be better.

> In addition to improving the documentation, my vote is to improve the
> discoverability of some of these sections.  I'll bet that the
> community tab on drupal.org is not clicked very often.  How about
> replacing that with a "tutorials" tab that points to a handbook page?

How about we measure?

> If people don't think that the top level link is worth changing, how
> about a menu item for a couple of these more important topics.


> Currently we spend menu space on "New Forum Topics" and "Who's Online"
> neither of which seems as important to me as some links to  
> "Tutorials" and some other handbook pages.

I attend a keynote style debate with two luminaries in the Human  
Computer Interaction field.   One argued as the artist, the other  
argued as an analyst.  The analyst claimed Amazon had 45 A/B testers  
on staff and 2 usability people.  In effect they just randomly switch  
around links between 2 options and which ever one led to the most  
sales they went with.   The anecdote was some what discredited, but I  
want to balance out the intuitive directions we are going with more  
analytical approach.

If we can agree we are not our users, then we are off to a good start.

Cheers,
Kieran




> Greg

-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.drupal.org/pipermail/documentation/attachments/20060830/7d125414/attachment.htm


More information about the documentation mailing list