[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