Go offline with the Player FM app!
Developer collaboration with Lorna Mitchell
Manage episode 462759339 series 2568080
🎓 Our host, Kate Mueller, is teaching a 4-session Information Architecture Master Class that starts on September 16th!
🎧 TNBTW listeners can use the coupon code "NOTBORING" during checkout to save 40% off the list price!
🔗 Read more info and sign up: thenotboringtechwriter.com/learning
—
In this episode, I’m talking with Lorna Mitchell, a technology leader, published author, tech blogger, and developer experience expert who is passionate about APIs and developer tools. We talk about why developers writing docs is good for both your devs and your docs, the best ways to build successful collaboration with developers, and more!
Lorna and I discuss her background as a developer who started doing documentation for her own resources and gradually moved into developer relations, developer advocacy, and developer experience. We chat about the wide range of writing she’s tackled–including books, readmes, and her blog–and why developers need to write to improve their skills.
We also discuss strategies tech writers can use to facilitate good collaboration with developers, including treating their role more as editors rather than writers; having a clearly-defined process with discrete, well-scoped requests for contributions; creating content type templates to streamline contributions; and having a second, shorter style guide for developers.
About Lorna Mitchell:
Lorna is based in Yorkshire, UK; she is a technology leader and developer experience expert who is passionate about APIs and developer tools. She is also a published author and regular blogger, sharing her insights on a variety of tech-related topics. Lorna serves on the OpenUK board, is on the Technical Steering Committee for OpenAPI specification, and maintains open source projects.
Resources discussed in this episode:
- Lorna’s developer style guide
- Diátaxis for content types
- Write the Docs’ Docs as Code resources
- Tanya Reilly’s Being Glue
—
Contact The Not-Boring Tech Writer team:
We love hearing your ideas for episode topics, guests, or general feedback:
Contact Kate Mueller:
Contact Lorna Mitchell:
Contact KnowledgeOwl:
59 episodes
Manage episode 462759339 series 2568080
🎓 Our host, Kate Mueller, is teaching a 4-session Information Architecture Master Class that starts on September 16th!
🎧 TNBTW listeners can use the coupon code "NOTBORING" during checkout to save 40% off the list price!
🔗 Read more info and sign up: thenotboringtechwriter.com/learning
—
In this episode, I’m talking with Lorna Mitchell, a technology leader, published author, tech blogger, and developer experience expert who is passionate about APIs and developer tools. We talk about why developers writing docs is good for both your devs and your docs, the best ways to build successful collaboration with developers, and more!
Lorna and I discuss her background as a developer who started doing documentation for her own resources and gradually moved into developer relations, developer advocacy, and developer experience. We chat about the wide range of writing she’s tackled–including books, readmes, and her blog–and why developers need to write to improve their skills.
We also discuss strategies tech writers can use to facilitate good collaboration with developers, including treating their role more as editors rather than writers; having a clearly-defined process with discrete, well-scoped requests for contributions; creating content type templates to streamline contributions; and having a second, shorter style guide for developers.
About Lorna Mitchell:
Lorna is based in Yorkshire, UK; she is a technology leader and developer experience expert who is passionate about APIs and developer tools. She is also a published author and regular blogger, sharing her insights on a variety of tech-related topics. Lorna serves on the OpenUK board, is on the Technical Steering Committee for OpenAPI specification, and maintains open source projects.
Resources discussed in this episode:
- Lorna’s developer style guide
- Diátaxis for content types
- Write the Docs’ Docs as Code resources
- Tanya Reilly’s Being Glue
—
Contact The Not-Boring Tech Writer team:
We love hearing your ideas for episode topics, guests, or general feedback:
Contact Kate Mueller:
Contact Lorna Mitchell:
Contact KnowledgeOwl:
59 episodes
All episodes
×Welcome to Player FM!
Player FM is scanning the web for high-quality podcasts for you to enjoy right now. It's the best podcast app and works on Android, iPhone, and the web. Signup to sync subscriptions across devices.