2 ms·
"...While producing high quality RNs can be hard and poses a variety of challenges to developers, a comprehensive empirical understanding of these challenges is
by belter 5y ago
"...While producing high quality RNs can be hard and poses a variety of challenges to developers, a comprehensive empirical understanding of these challenges is still lacking. In this paper, we bridge this knowledge gap by manually analyzing 1,731 latest GitHub issues to build a comprehensive taxonomy of RN issues with four dimensions: Content, Presentation, Accessibility, and Production. Among these issues, nearly half (48.47%) of them focus on Production; Content, Accessibility, and Presentation take 25.61%, 17.65%, and 8.27%, respectively.
We find that:
1) RN producers are more likely to miss information than to include incorrect information, especially for breaking changes;
2) improper layout may bury important information and confuse users;
3) many users find RNs inaccessible due to link deterioration, lack of notification, and obfuscate RN locations;
4) automating and regulating RN production remains challenging despite the great needs of RN producers..."
https://arxiv.org/pdf/2203.15592.pdf https://arxiv.org/pdf/2203.15592.pdf