A framework for describing documentor mindsets, and their associated considerations across the three dimensions is contributed, surface the need to reconsider existing perspectives of the documentation creation process, including the role of the documentor and metrics to measure documentation quality.
Deeksha M. Arya, Jin L. C. Guo, Martin P. Robillard· Empirical Software Engineeri...· 1 citation
This position paper uses systems thinking to trace how agent-mediated information seeking disrupts the balancing loops that currently contribute to documentation quality and how this disruption would create reinforcing loops that degrade documentation and code quality over time.
Avinash Bhat, Jin L. C. Guo· SIGSOFT FSE Companion· 1 citation
The work identifies five distinct stages of the documentation review process: self review, technical review, editorial review, play testing, and post-publication feedback, and draws on practitioners with distinct expertise to address quality across content, presentation, and user experience.
Avinash Bhat, Ian Arawjo, Disha Shrivastava et al.· 1 citation· ⚡1
We use cookies to run the site and, with your consent, for analytics and to show ads.
See our Cookie Policy.
