Bridging the docs gap

In this lightning talk that I gave for the October 2020 Salt docs jam, I describe a phenomenon I call the docs value-action gap. Then, I discuss strategies for bridging that gap in open source documentation.

Aug 15, 2021 - 8 min read

Creating effective community doc events (a case study)

The Salt project’s recent documentation jam was a huge success in terms of participation, productivity, diversity, and positive buzz. But why? In this blog entry, I break down the many elements that led to such a successful event.

Mar 15, 2021 - 13 min read

Getting started in open source as a new tech writer

Contributing to open source projects gives you valuable work experience and helps you build your professional network. Read my advice about using open source to land your first technical writing job.

Dec 13, 2020 - 10 min read

Attracting active contributors to open source (a case study)

Read my advice for attracting more active contributors to open source using lessons learned from the Good Docs Project.

Dec 6, 2020 - 8 min read