Replication Package: Writing Better Software Explanations: A Guideline-Based Approach
- Source
- DataCite
- Published
- 2026
- License
- Creative Commons Attribution 4.0 International
- Themes
- Machine Learning & AI
About this dataset
Description This replication package accompanies the study Writing Better Software Explanations: A Guideline-Based Approach, accepted at the 2026 IEEE 34th International Requirements Engineering Conference (RE). The study investigates how high-quality software explanations can be systematically supported through a guideline-driven approach and how such a guideline can be operationalized in a Large Language Model (LLM)-based formulation assistant. The research follows a sequential mixed-method design comprising (i) elicitation of candidate explanation quality properties from literature and user interviews, (ii) prioritization through a quantitative survey, (iii) derivation of a formulation guideline, and (iv) operationalization and evaluation of the guideline in a web-based LLM-supported tool. The tool supports developers in generating, checking, and iteratively revising explanations...
How the data was collected
data/survey-1-property-prioritization-results.xlsx: Anonymized dataset of the guideline prioritization survey containing the survey instrument, participant demographics, software experience information, prior experience with software-related explanation needs, item-level usefulness ratings for candidate explanation quality properties, and optional free-text comments. data/developer-study-manual-vs-tool-explanations.xlsx: Developer study dataset including explanation needs, app metadata, factual grounding content, participant identifiers for the manual and tool-supported conditions, recorded formulation times, paired manual and tool-supported explanations, and aggregated user-study rating...