Installing backstage.io on macOS (for technical writers)

Chris Rosser
6 min readJan 23, 2023

A job I recently applied to requires a candidate with experience writing docs for Backstage, Spotify’s open-source platform for creating developer portals. Backstage’s core TechDocs plugin uses MkDocs for content and YAML for configuration. While I’m very comfortable with MkDocs and YAML, my only experience with Backstage was watching introductory YouTube videos after a former colleague suggested we could use it at Specialized.

Naturally, I was intrigued, particularly as Backstage uses a documentation tool (MkDocs) I already use…

--

--

Chris Rosser

Technical writer and occasional author sharing thoughts on creativity, productivity and technology. Works at Canva. https://chrisrosser.substack.com