This talk was presented at API The Docs Virtual 2020 event series on 27 May. We are glad to present the video recording, slide deck and talk summary below. Enjoy!
Visit our talk recaps ToC page for an overview of all presentations!
Tom Johnson recently gathered information from more than 400 respondents from all around the world working in tech comm through a comprehensive 50-question survey. The survey focuses on how the trends of developer documentation differ for those working in API docs from those working with other types of docs. What is the greatest difference in methodology from other tech comm spaces?
Main topics of the survey:
In his talk, Tom presents and analyzes the findings of the research that can help orient, direct, and validate the experiences of technical writers working in the dev docs space.
Some questions that were raised by the results of the survey:
“What answer should you provide when someone asks you what tool you use? Is it the editor? Is it Markdown? Is it the static site generator? The build and deployment mechanism? Internal review tools?”
“If you pick up a pencil does the output you create differ from what you would create with a keyboard?”
An award-winning developer portal requires great accessibility, easy navigation, a mobile-friendly design, and a cl… https://t.co/1N2TSLgDdx