Tech Writing

These questions were only shown to the respondents who are involved in technical writing.

12% of the survey respondents said they were involved in technical writing, though only 9% have technical writing as their official job role.

When asked about their job roles, respondents were able to select more than one option.

What type of documentation do you write?

Compared to last year we see a 5-percentage-point increase in the number of developers who author customer-facing documentation.

What tools do you use to author documentation?

The docs-as-code approach is growing in popularity, as more people use developer tools for authoring documentation – 6 percentage points more than in 2021, to be exact.

Which markup language do you use to write technical documentation?

Markdown is still the most popular markup language, and 13% of those involved in technical writing use custom Markdown flavors to enrich its base functionality.

Do you reuse content between different documents / guides?

Even though 80% of respondents need to reuse content, more than one-third still copy and paste similar content manually.

6%

of those who write docs automate documentation checks, with broken markup, external links, and code samples being the most popular tests used. Interestingly, 10% also automate language checks.

58%

need to document APIs and 61% auto-generate API documentation, opting to use Swagger most of the time.

30%

automate routine work by configuring templates, mostly automating different types of topics, documents, and repeated content.