CODENS: Transforming Code Changes into Living, Accessible, and Queryable Documentation
Abstract
Maintaining up-to-date code documentation is difficult in fast-moving repositories because design knowledge is scattered across source files and pull requests. We present CODENS , a system that turns pull requests into living, accessible, and queryable documentation for production codebases. CODENS incrementally builds a typed software knowledge graph from pull requests, enriches components through schema-driven semantic extraction, derives typed relations between them, and exposes the resulting knowledge through three retrieval modes, including agent-guided graph traversal for repository-level question answering. The system also preserves semantic change history across pull requests and integrates both answer-quality and operational evaluation metrics. We evaluate CODENS on a client Ruby on Rails project in production. Results show that CODENS produces highly relevant and well-grounded answers, while qualitative feedback highlights a remaining challenge in concise, documentation-oriented synthesis.
Cite
@article{arxiv.2607.18356,
title = {CODENS: Transforming Code Changes into Living, Accessible, and Queryable Documentation},
author = {Abdelhak Kelious and Chyrine Tahri and Eliot Bardet},
journal= {arXiv preprint arXiv:2607.18356},
year = {2026}
}
Comments
Accepted at the 26th ACM Symposium on Document Engineering (DocEng 2026). DOI: 10.1145/3820755.3832807