[documentation] Docs survey

Pratul Kalia pratul at pratul.in
Tue Jan 13 16:06:16 UTC 2009


On Tue, Jan 13, 2009 at 9:18 PM, Addison Berry <drupal at rocktreesky.com> wrote:
> 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>


Can't spend much time on this (busy :-( ) but one suggestion -
Hindi/Urdu should be separated as Hindi and Urdu. They're not like the
Chinese variations.


cheers
pratul

-- 
Incoming!
 - OSScamp Pantnagar, 30 Jan - 1 Feb, 2009
 - Freed.in, 20 - 21 February, 2009
dum vivimus, vivamus.
http://pratul.in


More information about the documentation mailing list