Jump to content

Developer Satisfaction Survey/2026/Technical documentation

From mediawiki.org

๐Ÿ“– Developer Satisfaction 2026 Report

๐Ÿ—‚๏ธ Technical documentation

[edit]

tl;dr

  • Wikis are still popular tools for...
  • 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

โ€œHow often do you read technical documentation on a wiki?โ€
  • A majority (75%) said they read technical documentation on a wiki very or somewhat frequently
  • 19% said occasionally
  • 4% said very infrequently



# Reading preference

โ€œWhere do you prefer to read technical documentation? Rank the following from 1 (most preferred) to 4 (least preferred)โ€

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.


top


# Finding information

โ€œWhen you hit a roadblock/obstacle during a Wikimedia development task, how do you look for information to find a solution?โ€

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.


top


# Writing documentation

โ€œHow often do you write technical 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.

top


# Writing documentation preference

โ€œWhere do you prefer to write technical documentation?โ€

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)