[documentation] Docs survey

Addison Berry drupal at rocktreesky.com
Tue Jan 13 15:48:13 UTC 2009


I'm beginning to work up a survey about Drupal documentation. I'd like  
to keep it pretty short and sweet and I intend to do several  
throughout the year on various topics related to docs. This one is to  
get a very general idea of who uses the docs, which docs they use and  
a bit about participation. I have a draft braindump for the survey at  
the end of this email. (Note that "if" questions will use skip logic,  
so they will only be presented with one following line of questions).  
A short explanation and a link to the survey will be posted on the  
front page of Drupal.org. Feedback on this and topics for other  
potential surveys are welcome.

For actually running the survey, I'd rather not use SurveyMonkey. It  
is cool but also proprietary and I'd rather support open source. I  
don't really have the bandwidth for setting up webform/webform report  
modules or installing LimeSurvey, so I want to give LimeService a go.  
The nice thing about LimeService is it doesn't get into monthly fees  
(just based on usage) and we can do multi-lingual surveys. I think  
this first one, even though it has language questions on it, I'd  
rather stick to one survey in English. As we explore more multi- 
lingual needs for docs we can conduct a survey focused on that and use  
the feature at that point.

- Addi

DRAFT DOCUMENTATION SURVEY
=================================================

How long have you been using/playing with Drupal?
   less than a month
   1-6 months
   6 months to 1 year
   1-2 years
   2+ years

What roles do you take when working with Drupal? (check all that apply)
   End user
   Marketing/sales (selling Drupal to others)
   Site administrator (day to day maintenance)
   Site builder/architects (installation and putting the site together)
   Themer (create and/or customize the theme in code)
   Developer (write custom modules and tweaks)
   Other (describe what you do that we missed above) <text>

What forms of documentation about Drupal do you use?
   Drupal.org (including api.drupal.org)
   Published Drupal book(s) that you have purchased
   Drupal's built in help (in your Drupal site itself)
   Articles on various blogs/sites around the web (not Drupal.org)
   Company or organization internal documentation
   Other <text>

What is your native language?
   Chinese (any variety)
   English
   Spanish
   Hindi/Urdu
   Arabic
   Russian
   German
   French
   Italian
   Other <text>

If your native language is not English, do you use a native language  
Drupal resource?
   Yes
   No

If yes, which resource(s) do you use?
   Drupal community website
   Drupal community IRC channel
   Published book(s) in your language
   Translated Drupal internal help (in your Drupal site)
   Other <text>

Do you currently help documentation efforts for Drupal (edit/create  
handbook pages, work in the docs issue queue, submit translations,  
etc.)?
   Yes
   No

If yes, what tasks do you do?
   Edit handbook pages
   Create new handbook pages
   Provide transaltions (for core and/or contrib)
   Work on the Documentation issue queue
   Work on Drupal core issues related to documentation
   Write modules/patches for Documentation needs (Drupal.org  
customizations or contributed modules we use on d.o or for contrib)
   Take part in meetings, sprints and/or the mailing list discussions
   Other <text>

Of the tasks that you do, which is your favorite?
   Edit handbook pages
   Create new handbook pages
   Provide transaltions (for core and/or contrib)
   Work on the Documentation issue queue
   Work on Drupal core issues related to documentation
   Write modules/patches for Documentation needs (Drupal.org  
customizations or contributed modules we use on d.o or for contrib)
   Take part in meetings, sprints and/or the mailing list discussions
   Other <text>

Why?
<free text>

If no, why not?
   No time
   Not sure what to do
   Afraid you'll mess up
   Don't know English well enough
   Documentation is boring/lame
   Other <text>

Any thoughts about Drupal documentation you'd like to share?
<free text>



More information about the documentation mailing list