Accessibility, Web UI & UXAccessibility, Web UI & UX
Conference50min
BEGINNER

Useful and Beautiful Developer Docs and How to Create Them

The talk discusses the importance of quality developer documentation, sharing experiences of improving it. It delves into enhancing documentation quality, structuring for specific audience needs, crafting learning objectives, and adopting a Docs-As-Code approach for language inclusivity, spelling accuracy, and stylistic consistency.

Johannes Dienst
Johannes DienstAskUI

talkDetail.whenAndWhere

Thursday, June 20, 17:00-17:50
Linux
talks.description
Inadequate developer documentation can be detrimental to your product's success. Developers seek efficient problem-solving, and if your product fails to provide that, they will quickly move on.Join me as I share my experience of revamping developer documentation at my current company. Initially, the documentation was subpar and barely functional for many developers. Onboarding was challenging, and existing users struggled to accomplish their tasks effectively.In this talk, we will delve into the stages of enhancing documentation quality, complete with real-world examples of our journey. Gain insights into structuring your documentation to meet your audience's specific needs through segmentation. Discover the power of crafting learning objectives to streamline content focus. Additionally, I will demonstrate how adopting the Docs-As-Code approach can automatically ensure inclusive language, spelling accuracy, and stylistic consistency, resulting in an enjoyable reading experience.
talks.speakers
Johannes Dienst

Johannes Dienst

AskUI

Johannes Dienst is Developer Advocate at AskUI. His focus is on automation, documentation, and software quality.
comments.title

comments.speakerNotEnabledComments