Wait, wasn't that code here before? Detecting outdated software documentation

Wen Siang Tan, Markus Wagner, Christoph Treude

Research output: Chapter in Book/Report/Conference proceedingConference PaperResearchpeer-review

Abstract

Encountering outdated documentation is not a rare occurrence for developers and users in the software engineering community. To ensure that software documentation is up-to-date, developers often have to manually check whether the documentation needs to be updated whenever changes are made to the source code. In our previous work, we proposed an approach to automatically detect outdated code element references in software repositories and found that more than a quarter of the 1000 most popular projects on GitHub contained at least one outdated reference. In this paper, we present a GitHub Actions tool that builds on our previous work's approach that GitHub developers can configure to automatically scan for outdated code element references in their GitHub project's documentation whenever a pull request is submitted.

Original languageEnglish
Title of host publicationProceedings - 2023 IEEE International Conference on Software Maintenance and Evolution, ICSME 2023
EditorsAntonio Mastropaolo, Rosalia Tufano
Place of PublicationPiscataway NJ USA
PublisherIEEE, Institute of Electrical and Electronics Engineers
Pages553-557
Number of pages5
ISBN (Electronic)9798350327830
ISBN (Print)9798350327847
DOIs
Publication statusPublished - 2023
EventIEEE International Conference on Software Maintenance and Evolution 2023 - Bogota, Colombia
Duration: 1 Oct 20236 Oct 2023
Conference number: 39th
https://ieeexplore.ieee.org/xpl/conhome/10336175/proceeding (Proceedings)
https://conf.researchr.org/home/icsme-2023 (Website)

Conference

ConferenceIEEE International Conference on Software Maintenance and Evolution 2023
Abbreviated titleICSME 2023
Country/TerritoryColombia
CityBogota
Period1/10/236/10/23
Internet address

Keywords

  • code elements
  • outdated documentation
  • outdated references
  • software repositories
  • workflow automation

Cite this