Automatic Generation of Explainability Requirements and Software Explanations From User Reviews
Fuente:
arXiv
Saved in:
| Main Authors: | , , , , , , , , |
|---|---|
| Format: | Preprint |
| Published: |
2025
|
| Subjects: | |
| Online Access: | |
| Tags: |
Add Tag
No Tags, Be the first to tag this record!
|
| _version_ | 1866912473666289664 |
|---|---|
| author | Obaidi, Martin Fischbach, Jannik Droste, Jakob Deters, Hannah Herrmann, Marc Klünder, Jil Krätzig, Steffen Villamizar, Hugo Schneider, Kurt |
| author_facet | Obaidi, Martin Fischbach, Jannik Droste, Jakob Deters, Hannah Herrmann, Marc Klünder, Jil Krätzig, Steffen Villamizar, Hugo Schneider, Kurt |
| contents | Explainability has become a crucial non-functional requirement to enhance transparency, build user trust, and ensure regulatory compliance. However, translating explanation needs expressed in user feedback into structured requirements and corresponding explanations remains challenging. While existing methods can identify explanation-related concerns in user reviews, there is no established approach for systematically deriving requirements and generating aligned explanations. To contribute toward addressing this gap, we introduce a tool-supported approach that automates this process. To evaluate its effectiveness, we collaborated with an industrial automation manufacturer to create a dataset of 58 user reviews, each annotated with manually crafted explainability requirements and explanations. Our evaluation shows that while AI-generated requirements often lack relevance and correctness compared to human-created ones, the AI-generated explanations are frequently preferred for their clarity and style. Nonetheless, correctness remains an issue, highlighting the importance of human validation. This work contributes to the advancement of explainability requirements in software systems by (1) introducing an automated approach to derive requirements from user reviews and generate corresponding explanations, (2) providing empirical insights into the strengths and limitations of automatically generated artifacts, and (3) releasing a curated dataset to support future research on the automatic generation of explainability requirements. |
| format | Preprint |
| id |
arxiv_https___arxiv_org_abs_2507_07344 |
| institution | arXiv |
| publishDate | 2025 |
| record_format | arxiv |
| spellingShingle | Automatic Generation of Explainability Requirements and Software Explanations From User Reviews Obaidi, Martin Fischbach, Jannik Droste, Jakob Deters, Hannah Herrmann, Marc Klünder, Jil Krätzig, Steffen Villamizar, Hugo Schneider, Kurt Software Engineering Explainability has become a crucial non-functional requirement to enhance transparency, build user trust, and ensure regulatory compliance. However, translating explanation needs expressed in user feedback into structured requirements and corresponding explanations remains challenging. While existing methods can identify explanation-related concerns in user reviews, there is no established approach for systematically deriving requirements and generating aligned explanations. To contribute toward addressing this gap, we introduce a tool-supported approach that automates this process. To evaluate its effectiveness, we collaborated with an industrial automation manufacturer to create a dataset of 58 user reviews, each annotated with manually crafted explainability requirements and explanations. Our evaluation shows that while AI-generated requirements often lack relevance and correctness compared to human-created ones, the AI-generated explanations are frequently preferred for their clarity and style. Nonetheless, correctness remains an issue, highlighting the importance of human validation. This work contributes to the advancement of explainability requirements in software systems by (1) introducing an automated approach to derive requirements from user reviews and generate corresponding explanations, (2) providing empirical insights into the strengths and limitations of automatically generated artifacts, and (3) releasing a curated dataset to support future research on the automatic generation of explainability requirements. |
| title | Automatic Generation of Explainability Requirements and Software Explanations From User Reviews |
| topic | Software Engineering |
| url | https://arxiv.org/abs/2507.07344 |