DORA Community Discussion - Documentation
Moved to • DORA Community Discussion - Documentation
Michelle Irvine, technical writer from the DORA Research team, joins the DORA Community for a deep dive into the DORA's research into documentation and to share some ideas about how to improve your team's approach.
Quality documentation is foundational. It drives the successful implementation of technical capabilities and amplifies the impact those capabilities have on organizational performance. Documentation also has a positive impact on outcomes, such as team performance, productivity, and job satisfaction. However, increasing documentation quality doesn’t lead to better well-being for everyone: as the quality of documentation increases, some respondents report increased levels of burnout.
Resource links:
DORA Research - https://DORA.dev
2023 DORA Report - https://DORA.dev/research/2023/dora-r...
Documentation quality - https://dora.dev/devops-capabilities/...
Society for Technical Communications - https://www.stc.org/
Technical Writing Courses for Engineers - https://developers.google.com/tech-wr...
Write the docs - https://www.writethedocs.org/
Following the presentation, we stopped the recording and had a discussion about code reviews. The discussion was not recorded but checkout the mailing list on https://dora.community for a recap and for an ongoing discussion.
Join http://DORA.community to be notified of upcoming opportunities to join similar discussions.
Do you have topics related to the research that you'd like to discuss? Share them on the http://DORA.community discussion group.