Documentation Survey

I’m putting together a survey which we can get people to answer about WordPress’ documentation. I’ll get it online later this week, but I thought it would be worth seeing if you guys had any suggestions for questions that you think would be useful. The aim of the survey is to:

  • help to create a new architecture of the documentation
  • help us to discover pain points
  • create a list of priorities for new documentation

Okay, here’s what I’ve come up with so far.

Are you:

1. WordPress user (I use WordPress to run my website/blog)
2. WordPress builder (I build and customize websites but I don’t write PHPPHP PHP (recursive acronym for PHP: Hypertext Preprocessor) is a widely-used open source general-purpose scripting language that is especially suited for web development and can be embedded into HTML.
3. Novice developer (learning to write my first plugins/themes)
4. Intermediate developer (I write plugins and themes and they’re pretty good)
5. Advanced developer (I dream in PHP)

What documentation do you currently use (select all that apply):

1. Codex – guides
2. Codex – APIAPI An API or Application Programming Interface is a software intermediary that allows programs to interact with each other and share data in limited, clearly defined ways. documentation
3. Tutorials and guides on blogs
4. Books
5. Breaking WordPress/plugins/themes and putting them back together
6. Premium services
7. Screencasts
8. PHP docs and inline documentation
9. Forums (like or stack exchange)

How useful do you find the WordPress CodexWordPress Codex Living online manual to


What types of documentation/learning do you prefer?

1. Tutorials
2. User Guides
3. Breaking stuff and putting it back together
4. Screencasts
5. Code references and API documentation
6. In-person training
7. PHP docs and inline documentation

What’s the first place you go when you have a question about how something in WordPress works?

Other: [open]

What do you find most helpful about the Codex:


What problems do you face with the Codex (check all that apply):
Incomplete documentation
Out of date documentation
I can’t find what I need
Content isn’t clear
Content isn’t accurate
Difficult to navigate

What would you like to see more of:
Handbooks focused on specific tasks
Better code reference
Better inline help

What improvements to documentation would improve your experience of using or developing with WordPress:

[open field]

Have you ever contributed to the WordPress Codex:


Would you like to contribute to the WordPress Codex:


If you’ve never contributed to the Codex, can you please say why:

[open field]