Developer Satisfaction Survey/2021/Categories/Documentation
Appearance
📖 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.
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