Mapping the Information Journey: Unveiling the Documentation Experience of Software Developers in China

Zhijun Gao,Jiangying Wang,Meina Wang
2023-12-05
Abstract: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.
Human-Computer Interaction,Information Theory
What problem does this paper attempt to address?
The paper aims to address the following core issues: 1. **Characteristics of Chinese software developers in using technical documentation**: The study explores the behavioral differences between junior and senior developers when using technical documentation, including their personalities, learning habits, and work habits. 2. **The "information journey" of Chinese software developers**: By studying the process of developers from exploring to applying technical documentation, an information journey map was created, revealing the different stages (exploration, understanding, practice, application) that developers go through in the entire process. 3. **Developers' expectations for high-quality documentation**: The paper also analyzes developers' specific needs for technical documentation, such as content organization, maintenance, and updates, and provides corresponding suggestions to improve documentation quality. To answer these questions, researchers adopted a combination of semi-structured interviews and questionnaires, conducting in-depth interviews with 25 software developers in major Chinese cities and a broad survey of 177 participants. Ultimately, the research results not only enriched the understanding of the characteristics of Chinese software developers but also provided guidance for the design of high-quality technical documentation.