Codetations: Intelligent, Persistent Notes and UIs for Programs and Other Documents
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_ | 1866913808241393664 |
|---|---|
| author | Misback, Edward Vank, Erik Tatlock, Zachary Tanimoto, Steven |
| author_facet | Misback, Edward Vank, Erik Tatlock, Zachary Tanimoto, Steven |
| contents | Software developers maintain extensive mental models of code they produce and its context, often relying on memory to retrieve or reconstruct design decisions, edge cases, and debugging experiences. These missing links and data obstruct both developers and, more recently, large language models (LLMs) working with unfamiliar code. We present Codetations, a system that helps developers contextualize documents with rich notes and tools. Unlike previous approaches, notes in Codetations stay outside the document to prevent code clutter, attaching to spans in the document using a hybrid edit-tracking/LLM-based method. Their content is dynamic, interactive, and synchronized with code changes. A worked example shows that relevant notes with interactively-collected data improve LLM performance during code repair. In our user evaluation, developers praised these properties and saw significant potential in annotation types that we generated with an LLM in just a few minutes. |
| format | Preprint |
| id |
arxiv_https___arxiv_org_abs_2504_18702 |
| institution | arXiv |
| publishDate | 2025 |
| record_format | arxiv |
| spellingShingle | Codetations: Intelligent, Persistent Notes and UIs for Programs and Other Documents Misback, Edward Vank, Erik Tatlock, Zachary Tanimoto, Steven Software Engineering Human-Computer Interaction Software developers maintain extensive mental models of code they produce and its context, often relying on memory to retrieve or reconstruct design decisions, edge cases, and debugging experiences. These missing links and data obstruct both developers and, more recently, large language models (LLMs) working with unfamiliar code. We present Codetations, a system that helps developers contextualize documents with rich notes and tools. Unlike previous approaches, notes in Codetations stay outside the document to prevent code clutter, attaching to spans in the document using a hybrid edit-tracking/LLM-based method. Their content is dynamic, interactive, and synchronized with code changes. A worked example shows that relevant notes with interactively-collected data improve LLM performance during code repair. In our user evaluation, developers praised these properties and saw significant potential in annotation types that we generated with an LLM in just a few minutes. |
| title | Codetations: Intelligent, Persistent Notes and UIs for Programs and Other Documents |
| topic | Software Engineering Human-Computer Interaction |
| url | https://arxiv.org/abs/2504.18702 |