This research delves into understanding the behaviors and characteristics of Chinese developers in relation to their use of technical documentation, which is crucial for creating high-quality developer documentation. We conducted interviews with 25 software developers and surveyed 177 participants, using the preliminary interview findings to inform the survey design. Our approach encompassed traditional user research methods, including persona and user journey mapping, to develop typical personas and information journeys based on the qualitative data from the interviews and quantitative results from the survey. Our results revealed distinct characteristics and differences between junior and senior developers in terms of their use of technical documentation, broadly categorized into personality traits, learning habits, and working habits. We observed that the information journey of both groups typically encompasses four stages: Exploration, Understanding, Practice, and Application. Consequently, we created two distinct personas and information journey maps to represent these two developer groups. Our findings highlight that developers prioritize the content, organization, and maintenance aspects of documentation. In conclusion, we recommend organizing documentation content to align with developers' information journeys, tailoring documentation to meet the needs of developers at various levels, and focusing on the content, organization, and maintenance aspects of documentation.
翻译:本研究深入探讨了中国开发者在技术文档使用方面的行为与特征,这对于创建高质量的开发者文档至关重要。我们访谈了25名软件开发者,并对177名参与者进行了问卷调查,利用初步访谈结果指导调查设计。我们的方法涵盖了传统用户研究方法,包括用户画像和用户旅程地图,基于访谈的定性数据与调查的定量结果,构建了典型的用户画像及信息旅程。研究结果揭示了初级与高级开发者在技术文档使用上的显著特征与差异,这些差异大致可归为个性特质、学习习惯与工作习惯三类。我们观察到,两组开发者的信息旅程通常包含四个阶段:探索、理解、实践与应用。基于此,我们创建了两种不同的用户画像及其对应的信息旅程地图,以代表这两类开发者群体。研究发现表明,开发者尤为关注文档的内容、组织与维护方面。最后,我们建议:根据开发者的信息旅程组织文档内容,针对不同级别开发者的需求进行文档定制,并持续聚焦于文档的内容、组织与维护工作。