Documentation strategy and coordination

My role in developing this documentation

While embedded in multiple engineering teams, I developed documentation strategy, implemented documentation tooling, and contributed original documentation.

I was primarily responsible for three main documentation projects:

• Ubuntu on WSL: the Ubuntu distribution for the Windows Subsystem for Linux (WSL)
• authd: a tool for cloud authentication on Ubuntu
• ADSys: a client for bridging Ubuntu systems with Active Directory

Each project used Sphinx with MyST-flavoured markdown. The sources were hosted publicly on GitHub and maintained using a docs-as-code workflow. The documentation was published using Read the Docs.

As I developed my understanding of the software, I also began contributing to to UX decisions. I wrote about my early experiences of this development in contributing to design as a technical author.

A significant part of my work was driving documentation efforts within engineering teams. But I also took ownership of developing documentation from scratch, including but not limited to:

• Create a custom Ubuntu distro for WSL
• Security overview for WSL
• Explaining Pro for WSL
• Architecture reference for Ubuntu WSL
• How to upgrade Ubuntu on WSL
• Get started tutorial for ADSys
• Set up a Go development environment on Ubuntu Desktop
• Go development tutorial for Ubuntu Desktop
• Wiki page on the Linux PATH

A full example of developer-facing documentation that I write is included in this portfolio: Develop with Go on Ubuntu.