UX for Docs: Documentation Engineering at Rubin
2023-11-07 , Talks

At Rubin Data Management we set out early in Construction to create a healthy documentation culture. In order to provide a good UX for documentation contributors, we developed a documentation infrastructure (now also used by the NASA SphereX project) that values low-friction documentation creation and guaranteed-accurate documentation techniques. By using development tools such as Github Actions, Slack bots and Jupyter Notebooks, we are battling successfully the traditional view of documentation as the chore of last resort for both writers and readers.

See also:

Jonathan is a senior DevOps engineer at Rubin Observatory, and now contributes as a contractor through J.Sick Codes Inc. from Canada. Jonathan's main contributions are to Rubin's documentation platform, science platform, and internal developer service infrastructure, Jonathan's go-to technologies are Python and FastAPI for web applications, React/Next.js for front-end applications, Kafka for event streaming, and Kubernetes with Argo CD for application deployment. Previously Jonathan received a PhD in astronomy from Queen's University for a near-UV to near-IR study of the Andromeda Galaxy's integrated and resolved stellar populations with CFHT.