{"type":"rich","version":"1.0","provider_name":"Transistor","provider_url":"https://transistor.fm","author_name":"The Not-Boring Tech Writer","title":"Developer collaboration with Lorna Mitchell","html":"","width":"100%","height":180,"duration":2626,"description":"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!\n—\nLorna 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.\nWe 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.\nAbout Lorna Mitchell:\nLorna 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.\nResources discussed in this episode:Lorna’s developer style guideDiátaxis for content typesWrite the Docs’ Docs as Code resourcesTanya Reilly’s Being Glue—\nContact The Not-Boring Tech Writer team:\nWe love hearing your ideas for episode topics, guests, or general feedback:tnbtw@knowledgeowl.comBlueskyLinkedIn\n\nContact Kate Mueller: knowledgewithsass.comLinkedIn\n\nContact Lorna Mitchell: Lorna's websiteLinkedin\n\nContact KnowledgeOwl:KnowledgeOwl.com","thumbnail_url":"https://img.transistorcdn.com/JlP4_zZATprOmI0COWYcSJZswo0AzjaOmxyE_M5gX6M/rs:fill:0:0:1/w:400/h:400/q:60/mb:500000/aHR0cHM6Ly9pbWct/dXBsb2FkLXByb2R1/Y3Rpb24udHJhbnNp/c3Rvci5mbS9kNTdh/ZjBlMjA5ZmEwZDhh/NTNjZWFiOWM2NWY1/ZDAzNS5qcGc.webp","thumbnail_width":300,"thumbnail_height":300}