InterLink: Linking Text with Code and Output in Computational Notebooks Conference: CHI Conference on Human Factors in Computing Systems; April 26-May 1, 2025; Yokohama, Japan CHI Conference on Human Factors in Computing Systems (CHI ’25), April 26-May 1, 2025, Yokohama, Japan DOI: 10.1145/3706598.3
Yanna Lin, Leni Yang, Haotian Li, Huamin Qu, Dominik Moritz · 2025
Read InterLink: Linking Text with Code and Output in Computational Notebooks Conference: CHI Conference on Human Factors in Computing Systems; April 26-May 1, 2025; Yokohama, Japan CHI Conference on Human Factors in Computing Systems (CHI ’25), April 26-May 1, 2025, Yokohama, Japan DOI: 10.1145/3706598.3 by Yanna Lin, Leni Yang, Haotian Li, Huamin Qu, Dominik Moritz (2025) in the Tower of Babel, a free online library of public-domain works preserved in clean, searchable text. No sign-up. The full text is served as a plain-text file at a predictable URL, where text is present: https://antarctic-labs.com/tower-of-babel/arxiv-2502-16114.txt.
Introduction
Data analysts keep their work in notebooks that mix prose, code, and results, but the usual single column scatters linked pieces far apart. Yanna Lin and four co-authors built a plugin in 2025, called InterLink, that redraws the layout to show those links. Text sits in one column, code and output in another, with drawn lines tying each passage to its match.
The design grew out of a study of readers' pain points with shared notebooks. In a test with twelve users, those with the plugin found and combined scattered facts more accurately, by about fourteen percent. The authors say making links visible turns a notebook from a scroll into a map. They offer it as a step toward notebooks written to be read, not just run.
Catalog record
| CREATOR | Yanna Lin, Leni Yang, Haotian Li, Huamin Qu, Dominik Moritz |
|---|---|
| YEAR | 2025 |
| COLLECTION | PAPERS |
| FORMAT | TXT |
| FILE SIZE | 80 KB |
| VERSION | 1.0 |
| LICENSE | http://creativecommons.org/licenses/by/4.0/ |
| RIGHTS | CC BY |
| SOURCE | arXiv |
Source: https://arxiv.org/abs/2502-16114
Browse the full library · About the Tower of Babel
Full text
The opening of the work, from the library's hosted text:
InterLink: Linking Text with Code and Output in Computational Notebooks Conference: CHI Conference on Human Factors in Computing Systems; April 26-May 1, 2025; Yokohama, Japan CHI Conference on Human Factors in Computing Systems (CHI ’25), April 26-May 1, 2025, Yokohama, Japan DOI: 10.1145/3706598.3714104 ISBN: 979-8-4007-1394-1/25/04 Conference: Make sure to enter the correct conference title from your rights confirmation emai; June 03–05, 2018; Woodstock, NY CCS: Human-centered computing Graphical user interfaces Yanna Lin, Leni Yang, Haotian Li, Huamin Qu, Dominik Moritz Abstract . Computational notebooks, widely used for ad-hoc analysis and often shared with others, can be difficult to understand because the standard linear layout is not optimized for reading. In particular, related text, code, and outputs may be spread across the UI making it difficult to draw connections. In response, we introduce InterLink, a plugin designed to present the relationships between text, code, and outputs, thereby making notebooks easier to understand. In a formative study, we identify pain points and derive design requirements for identifying and navigating relationships among various pieces of information within notebooks. Based on these requirements, InterLink features a new layout that separates text from code and outputs into two columns. It uses visual links to signal relationships between text and associated code and outputs and offers interactions for navigating related pieces of information. In a user study with 12 participants, those using InterLink were 13.6% more accurate at finding and integrating information from complex analyses in computational notebooks. These results show the potential of notebook layouts that make them easier to understand. Figure 1. InterLink helps analysts read and understand computational notebooks by linking text to code and outputs using a side-by-side layout. Clicking the icon in the toolbar (b1) activates InterLink, switching the layout of the notebook from a linear layout (A) to a side-by-side layout (B). In (B), the “observation” cell, marked with the fixed icon (b2), indicates that it has been fixed in place through a click, ensuring it remains visible on the screen for easy reference. A linking line (b3) explicitly connects the “observation” cell to the code cell (b4). Visual cues (b5-b7), including colored underlines, dashed borders, and dashed sketches, indicate the existence of relationships between segments or cells. Composite figure showing user frustration with a traditional long, linear notebook on the left, and an innovative side-by-side layout of our system on the right. The left side depicts a notebook with dense text and graphics, overlayed with a user's thought bubble expressing difficulty in locating information due to the notebook's complexity. The right side shows our system's interface with observations noted on the left pane and corresponding code and outputs on the right pane, simplifying data navigation and linking results directly to their source code. † † cc-license: by-nc-sa 1. Introduction Computational notebooks, such as Jupyter ( Jupyter [n. d.] ) and RStudio ( Posit [n. d.] ) , have become essential tools in data science and research. Adhering to the literate programming principle, they combine executable code , code outputs, and descriptive text in a single document, making the rationale behind computations accessible ( Knuth 1984 ) . These notebooks are structured into discrete units of computation and descriptive text, known as “cells”, which can be executed and edited independently. This flexible design not only streamlines the iterative process of code testing and refinement but also simplifies the integration of comprehensive descriptive text alongside computational content. As a result, computational notebooks are frequently created and shared among various stakeholders, so there is a wide audience that needs to read and understand the notebooks ( Ramasamy et al. 2023 ) . However, understanding shared computational notebooks is challenging. Though a notebook author may make the best effort to clean the code and output cells and write descriptive and explanatory text, readers still face three major challenges when trying to identify and navigate the relationships between the text, code, and outputs 1 1 1 For brevity, the term “relationship” in the remainder of this paper refers to the relationships between the text, code, and outputs. . The first is to be aware of related text for code or outputs. The location of text relative to its corresponding code or outputs can vary significantly. Text describing some code or output can appear above, below, or far away from the relevant code or outputs, depending on the author’s preferences or the type of descriptive text ( Wang et al. 2022b ) . Consequently, readers may not realize the existence of related text for extra information when reading specific code and output cells, and vice versa . The second is sorting out the complex relationships between code, outputs, and text, which may exhibit many-to-many relationships at different granularities. Even when readers are aware that relevant information exists, having a clear view of all the relationships and locating them is challenging. The relationships between code, outputs, and text often involve many-to-many mappings at different levels of granularity. In many-to-many relationships, a single text cell can be related to one or more code or output cells, and several text cells can relate to a single code or output cell. Furthermore, these elements can be related at different granularities. For example, a specific output cell may be related to a segment of a text cell that summarizes findings from multiple output cells. In such cases, reader s might find it challenging to locate the related content and identify the specific connections because they need to process and filter extensive information. The third is retaining and synthesizing the relationship information. Even when relationships of code , outputs, and text are clarified, readers may still struggle to retain and synthesize them for understanding. When the notebook is long or contains unrelated cells interspersed among relevant information, readers have to scroll back and forth to collect, remember, and process relevant information. Existing research on making computational notebooks more readable has predominantly focused on isolated aspects, such as code organization ( Head et al. 2019 ; Weinman et al. 2021 ; Wang et al. 2022a ) and descriptive text generation ( Lin et al. 2024 ; Wang et al. 2022b ) . These approaches, while valuable, often overlook the interplay between code , outputs, and text. Recent efforts have aimed to address this gap by implementing structured outlines within computational notebooks ( Chattopadhyay et al. 2023 ; Rule et al. 2018a ) . Nonetheless, they mainly applied headlines to structure computational notebooks and neglected a substantial portion of the narrative content in other types, which constitutes approximately 68% of the descriptive text ( Wang et al. 2022b ) . Furthermore, previous studies have reported readers’ desire for more granular explanations that extend beyond headers to single code statement explanations ( Chattopadhyay et al. 2023 ) . To fill this gap, our work proposes a tool, InterLink, that clearly presents relationships between the text, code, and outputs to help readers identify and navigate related information in notebooks, thereby making them easier to understand. Rather than specifying these relationships, which we leave for future work, this work investigates whether explicitly presenting these relationships in a reading-optimized design can improve the readability of computational notebooks. To inform InterLink’s design, we first conducted a formative study