Guardado en:
Detalles Bibliográficos
Autores principales: Pöttgen, Daniel, Sadeghi, Mersedeh, Unterbusch, Max, Vogelsang, Andreas
Formato: Preprint
Publicado: 2026
Materias:
Acceso en línea:https://arxiv.org/abs/2601.05721
Etiquetas: Agregar Etiqueta
Sin Etiquetas, Sea el primero en etiquetar este registro!
_version_ 1866914243269361664
author Pöttgen, Daniel
Sadeghi, Mersedeh
Unterbusch, Max
Vogelsang, Andreas
author_facet Pöttgen, Daniel
Sadeghi, Mersedeh
Unterbusch, Max
Vogelsang, Andreas
contents The increasing complexity of modern software systems has made understanding their behavior increasingly challenging, driving the need for explainability to improve transparency and user trust. Traditional documentation is often outdated or incomplete, making it difficult to derive accurate, context-specific explanations. Meanwhile, issue-tracking systems capture rich and continuously updated development knowledge, but their potential for explainability remains untapped. With this work, we are the first to apply a Retrieval-Augmented Generation (RAG) approach for generating explanations from issue-tracking data. Our proof-of-concept system is implemented using open-source tools and language models, demonstrating the feasibility of leveraging structured issue data for explanation generation. Evaluating our approach on an exemplary project's set of GitHub issues, we achieve 90% alignment with human-written explanations. Additionally, our system exhibits strong faithfulness and instruction adherence, ensuring reliable and grounded explanations. These findings suggest that RAG-based methods can extend explainability beyond black-box ML models to a broader range of software systems, provided that issue-tracking data is available - making system behavior more accessible and interpretable.
format Preprint
id arxiv_https___arxiv_org_abs_2601_05721
institution arXiv
publishDate 2026
record_format arxiv
spellingShingle From Issues to Insights: RAG-based Explanation Generation from Software Engineering Artifacts
Pöttgen, Daniel
Sadeghi, Mersedeh
Unterbusch, Max
Vogelsang, Andreas
Software Engineering
The increasing complexity of modern software systems has made understanding their behavior increasingly challenging, driving the need for explainability to improve transparency and user trust. Traditional documentation is often outdated or incomplete, making it difficult to derive accurate, context-specific explanations. Meanwhile, issue-tracking systems capture rich and continuously updated development knowledge, but their potential for explainability remains untapped. With this work, we are the first to apply a Retrieval-Augmented Generation (RAG) approach for generating explanations from issue-tracking data. Our proof-of-concept system is implemented using open-source tools and language models, demonstrating the feasibility of leveraging structured issue data for explanation generation. Evaluating our approach on an exemplary project's set of GitHub issues, we achieve 90% alignment with human-written explanations. Additionally, our system exhibits strong faithfulness and instruction adherence, ensuring reliable and grounded explanations. These findings suggest that RAG-based methods can extend explainability beyond black-box ML models to a broader range of software systems, provided that issue-tracking data is available - making system behavior more accessible and interpretable.
title From Issues to Insights: RAG-based Explanation Generation from Software Engineering Artifacts
topic Software Engineering
url https://arxiv.org/abs/2601.05721