Published April 15, 2026 | Version v1
Presentation Open

Documentation as Infrastructure

  • 1. ROR icon Purdue University System

Description

Scientific software often fails not because of algorithms, performance, or infrastructure, but because teams cannot sustain the knowledge required to maintain it. As research groups grow and rotate, documentation becomes fragmented, outdated, or entirely absent—creating onboarding friction, duplicated effort, and long‑term maintenance risk. At Purdue University’s Rosen Center for Advanced Computing (RCAC), I have worked across multiple research software and training projects to design and implement a centralized documentation strategy that treats documentation as shared infrastructure rather than a side task.

Notes

This talk presents a practical, lightweight framework for building sustainable documentation systems in scientific software teams. I will share lessons learned from unifying documentation across HPC workflows, training pipelines, and collaborative development environments, including how to establish documentation ownership, structure contributor‑friendly content, and integrate automation to reduce maintenance overhead. I also discuss where AI‑assisted tools can responsibly support documentation work without compromising accuracy or reproducibility.

Attendees will leave with actionable templates, governance patterns, and workflow recommendations that can be adopted by teams of any size. By reframing documentation as a core component of software sustainability, we can reduce technical debt, improve developer experience, and strengthen the long‑term impact of scientific research.

Files

Documentation as Infrastructure.pdf

Files (225.8 kB)

Name Size Download all
md5:bf0d552e10dc1ec421847dcf0bcc5d66
225.8 kB Preview Download

Additional details

Additional titles

Subtitle
A Practical Framework for Sustainable Scientific Software