arXivDaily arXiv每日学术速递 周一至周五更新
arXiv周末暂无论文更新,休息一下吧,周末愉快~~

Ritgard:GitHub上社会技术制品的主题岛屿

Ritgard: T(r)opical Islands of Socio-Technical Artifacts on GitHub

Adam Štěpánek, Marco Raglianti, Jan Byška, Barbora Kozlíková, Michele Lanza

arXiv 2609.05278首次发表:更新:

AI 中文总结

Ritgard是一款挖掘GitHub仓库中Issues、Pull Requests、Discussions等社会技术制品并将其可视化为3D主题岛屿的工具,可展现项目功能与关注点的演化,同时呈现其可视化的技术挑战。

AI 中文摘要

软件项目远不止于代码,非代码制品通常记录了源代码背后的人类过程与决策,库变更的原理、架构决策、用户遇到的问题等,都是社会技术制品(STA)中常见的信息,这些制品在与代码仓库分离的渠道中创建和留存(有时非常接近,例如GitHub Issues与GitHub仓库)。STA是关于项目架构及其演化的信息宝库,包含仅靠代码无法提供的细节与洞见。遗憾的是,由于STA常分散在不同沟通渠道且以自然语言书写,这些信息难以提取和探索。本文提出Ritgard工具,它会挖掘GitHub仓库中的STA,即Issues、Pull Requests和Discussions,并将其可视化为覆盖树木的3D岛屿:每棵树代表单个制品,每个岛屿是通过文本嵌入与文本摘要结合从制品中提取的主题;岛屿的地形随主题活跃而从海洋升起,随主题过时而沉回海洋,以此描绘项目生命周期中功能与关注点的演化。本文介绍了该工具的使用方法与实现,展示了Ritgard可视化背后的诸多技术挑战。

英文摘要

A software project is more than just code. Non-code artifacts often document the human processes and decisions behind source code. The rationale behind a library change, an architectural decision, a problem encountered by a user are all examples of information typically present in socio-technical artifacts (STAs), created and persisted in channels separate from the repository itself (yet sometimes very close---e.g., GitHub Issues with GitHub repositories). These STAs are a trove of information about the project's architecture and its evolution, containing details and insights that code alone cannot provide. Unfortunately, this information is not easily extracted and explored as STAs are frequently fragmented over different communication channels, and are written in natural language. We present Ritgard, a tool that mines GitHub repositories for their STAs, namely Issues, Pull Requests, and Discussions, and visualizes them as 3D islands covered with trees. Each tree represents a single artifact and each island is a topic extracted from the artifacts through a combination of text embedding and text summarization. The terrain of the islands rises out of the ocean as the topic becomes active and sinks back in when it becomes stale, thus depicting the evolution of features and concerns throughout the project's lifetime. We describe the tool's usage and implementation, showing the numerous technical challenges behind Ritgard's visualization.

Comments5 pages, 3 figures, tool demo paper accepted at VISSOFT 2026

论文原文

arXiv 摘要页 · PDF 原文 · HTML 原文

↑