Developer Satisfaction Survey/2021/Categories/Documentation

📖 Developer Satisfaction 2021

The developer satisfaction survey is an annual survey of the Wikimedia developer community.

Documentation

edit

💬 I feel like there is lots of confusion about what goes on Meta, MediaWiki.org, and Wikitech, and things are spread out a bit.

29%
🔖

29% of comments mention document organization

13%
💳

13% of comments were about lack of resources to make docs better

Examples

edit

We asked people to provide examples of good documentation that they've seen.

📌 Good docs
Link % that mention
https://www.mediawiki.org/wiki/MediaWiki-Docker 18% (the "recipes" section in particular gets a couple callouts)
https://www.mediawiki.org/wiki/Gerrit 8%
https://www.mediawiki.org/wiki/Manual:Object_cache 5%
https://www.mediawiki.org/wiki/Manual:Coding_conventions 5%
https://wikitech.wikimedia.org/wiki/Blubber 5%

Documentation types

edit

We asked about 3 different types of documentation: Quickstart documentation, Tutorials, and Background and Context documentation for all of our categories