RT @DeliberateComp1: "How cognitive biases and ranking can foster an ineffective architecture and design" Don't miss out on… https://t.co/Njau4ATXn0
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!
Senior Technical Programmer Writer at Amazon
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?”
Check the survey results or find out more about the webinar.
RT @DeliberateComp1: "How cognitive biases and ranking can foster an ineffective architecture and design" Don't miss out on… https://t.co/Njau4ATXn0
RT @DeliberateComp1: "APIs: Semi-permeable, osmotic interfaces" Don't miss out on @dawnahukanna's talk next week at the… https://t.co/rF2qm9E2WM
Deliberate Complexity 2022 features a series of three events organized by @pronovix with the intent to create a spa… https://t.co/5ZkCEKHS7S
Deliberate Complexity 2022 features a series of three events organized by @pronovix with the intent to create a spa… https://t.co/uFiX820fCE
Big thanks to @palantir and @pronovix for sponsoring the #drupal update project bot. This tool is a major reason… https://t.co/OVYevQEFLG