[drupal-docs] Moving handbook to docs.drupal.org

Shane Birley shane at vbcreative.com
Fri Mar 18 18:32:41 UTC 2005


This is why I remind myself of who the audience is when I am 
consolidating documentation for people that want to use Drupal. 

1. Those who are not technically inclined get "step by step" 
instructions that I edit and make sure they understand them.

2. Those who are interested in learning about how the software works, 
they get a little more tech stuff.

We can't assume at all that those coming to the Drupal site have any 
idea what a CMS is.  People want to use the software because there are 
those like me who are out there talking it up but we leave a lot of 
people in the dark because the documentation is written in such a way 
that, at times, doesn't make a whole lot of sense.  They do to someone 
who is "nerd" but more and more people who aren't "nerds" are coming to 
the site.

So, I think this is an opportunity to define who the users are and who 
the developers are and make sure the docs speak in one way and the 
handbook in another. 

That is the way I think it would work.

Shane

>
> Well, I would not call most of the development info of projects *user* 
> focused: cvs messages, issue submission (with patches!), discussions 
> about the future of different modules (like htmlarea). But this 
> happened before, the new theme system was discussed online in a news 
> item directly accessible from the homepage. I would not call these 
> activities user focused in any way.
>
> Goba





More information about the drupal-docs mailing list