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

Get the data from DataCite

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...

Browse sustainability datasets on SusanHub