Developer Satisfaction Survey/2026/Technical documentation
๐ Developer Satisfaction 2026 Report
๐๏ธ Technical documentation
[edit]tl;dr
- Wikis are still popular tools for...
- reading documentation - wikis are still the most popular place to read documentation (similar to last year)
- writing documentation - 80% prefer to write documentation on wiki, similar to last year.
- When faced with an obstacle during Wikimedia development work, the two most preferred methods for finding solutions are searching on codesearch and using a generic websearch (whereas last year, the top two were searching on a wiki and searching on codesearch).
# Reading documentation on wikis
- A majority (75%) said they read technical documentation on a wiki very or somewhat frequently
- 19% said occasionally
- 4% said very infrequently

# Reading preference
On a wiki had the highest mean rank, and was also ranked #1 (most preferred) by the most participants.

For the respondents who said "somewhere else", one emergent theme was that the location or format of documentation may be less relevant than just finding something accurate that answers your question.
- Several replies mentioned using LLMs or AI chat bots
- Several replies mentioned other other websites, like Stack Overflow or Read the Docs.
# Finding information
Last year, there was a tie between "Searching on a single wiki" and "Searching on codesearch" being ranked as the top methods for solution-finding.
This year, the top method was overwhelmingly "Search on codesearch". "Using a generic web search" was the second most highly ranked (up from third last year). "Searching on a single wiki" was the third most highly ranked.

For respondents who ranked "somewhere else", Phabricator recurred most frequently as another place people look for information to unblock themselves.
# Writing documentation
- 45% said somewhat or very frequently write documentation
- 35% said they occasionally write documentation
- 17% said very infrequently write documentation
- 3% were unsure
Of note: 0% said never write documentation, down from 9% last year.

# Writing documentation preference
Respondents could select more than one answer.
- 80% said โon a wikiโ (similar to 84% last year)
- 56% said โin code commentsโ (down from 65% last year)
- 45% said โin Markdown files in a code repositoryโ (similar to 48% last year)
- 4% said โsomewhere elseโ (similar to 4% last year)
