Hi, I’m Joan Edwards, a Senior Technical Writer at Pantheon.
Before joining Pantheon’s Docs team, I wrote docs for a number of open-source projects. A hefty part of my technical writing duties was not only creating docs, but trying to drive community engagement - because a common challenge for many of the teams I worked with, was getting consistent and meaningful docs contributions. I quickly learned that an open-source project without good docs is just not sustainable. To be a thriving community you need to have contributors, and to get contributors you have to have established (documented) processes and organized information. Having lackluster, incomplete, or unreliable documentation really inhibits project growth by discouraging community engagement.
Never have Kevin Costner’s words “If you build it, they will come ‘’ held more true than when speaking about docs and community engagement in open-source (Okay… I’ll admit that’s a bit hyperbolic, but it definitely is somewhat true!)
Being at Pantheon has been so enlightening, and also very different from my previous roles. There is an amazing community here and folks are just eager to ask questions and share knowledge; it’s wonderful! It’s always awesome to scan our docs repo and see all the amazing contributions! I am really excited to see how we will continue to drive and sustain that engagement.
Ask me anything! Please note, I am much more likely to have a decent answer if the question is related to any of the following topics:
- Contributing to open-source projects that address social change
- Drupal Asheville 2021
- Write the Docs
- Nicolas Cage