Documentation: The Missing Pieces by Adrienne Tacke
Document all the things, they say! But are we documenting for ALL the PEOPLE? It seems that most documentation is written for the intermediate and above devs, the devs who have been around, and the devs who are already comfortable with programming.
But what about the true beginners, the career-transitioners, or those crossing domains? Most documentation is certainly not written for them!
In this talk, we'll explore
Common oversights and assumptions most documentation has built-in by default
Techniques that make our documentation more approachable for all kinds of people
How to strengthen our technical writing skills to ensure, to the best of our ability, that every anticipated reader of our documentation never feels lost or frustrated.
By the end of this talk, you'll leave and never write documentation in the same way again...and that's a good thing!
https://jsconfbp.com/speakers/adrienne-tacke
About Adrienne:
Currently a Senior Developer Advocate for MongoDB, Adrienne Tacke is also a Filipina software engineer, speaker, published author of the book Coding for Kids: Python, and a LinkedIn Learning instructor who specializes in Cloud Development courses. Perhaps most important, however, is that she spends way too much money on desserts and ungodly amounts of time playing Cyberpunk 2077.
Видео Documentation: The Missing Pieces by Adrienne Tacke канала JSConf
But what about the true beginners, the career-transitioners, or those crossing domains? Most documentation is certainly not written for them!
In this talk, we'll explore
Common oversights and assumptions most documentation has built-in by default
Techniques that make our documentation more approachable for all kinds of people
How to strengthen our technical writing skills to ensure, to the best of our ability, that every anticipated reader of our documentation never feels lost or frustrated.
By the end of this talk, you'll leave and never write documentation in the same way again...and that's a good thing!
https://jsconfbp.com/speakers/adrienne-tacke
About Adrienne:
Currently a Senior Developer Advocate for MongoDB, Adrienne Tacke is also a Filipina software engineer, speaker, published author of the book Coding for Kids: Python, and a LinkedIn Learning instructor who specializes in Cloud Development courses. Perhaps most important, however, is that she spends way too much money on desserts and ungodly amounts of time playing Cyberpunk 2077.
Видео Documentation: The Missing Pieces by Adrienne Tacke канала JSConf
Показать
Комментарии отсутствуют
Информация о видео
Другие видео канала
Impressions of JSConf India 2023Jsconf India 2023 - Track 1Jsconf India Track 2How Vue.js as a web framework optimises rendering speedWhich web framework is better? React? Vue? Angular?JavaScript Closures in React HooksRebuild React Hooks yourself for NodeJSConf Chile - día 2JSConf Chile dia 1Art in the times of Machine Learning and AIThe Secret Web Performance Metric No One Is Talking About by Anna Migas | JSConf Korea 2022The Journey About How I Fixed a Bug in the Node.js Core That Affected Thousands of PackagesAccessibility with Svelte - Beyond Compiler Warnings by Anuradha Kumari | JSConf Korea 2022The Next Exciting JavaScript Feature: Records & Tuples by Nicolò Ribaudo | JSConf Korea 2022How to Fail Successfully by Eleanor Rumsey | JSConf Korea 2022Understanding and Optimizing Interaction to Next Paint (INP) by Jeremy Wagner | JSConf Korea 2022It's the markup that matters by Hidde de VriesHow Your Bundle Size Affects The Climate by Roy DerksCommunicating Intention with Functional TypeScript by Thiago TempleDX is UX by Mathieu Anderson