{"type":"rich","version":"1.0","provider_name":"Transistor","provider_url":"https://transistor.fm","author_name":"Knowledgebase Ninjas","title":"Why Human-Written Docs Are the Best AI-Optimized Docs - Gareth Brinn","html":"","width":"100%","height":180,"duration":1689,"description":"In this episode of Knowledge Base Ninjas, host Gowri speaks with Gareth Brinn, Documentation Manager at Gravitee, about what changes in a documentation team when AI enters the workflow. \nGareth says that AI is an optimisation tool, not a replacement. He reframes manual documentation as manual context building: understanding user journeys, talking to solutions engineers and support teams, and structuring information so agents can use it. Human-generated content, he argues, is AI-optimised content — if docs read well to an AI, it's because someone did the manual work to get them there. \nHe explains why the \"one agent to rule them all\" idea fails, and why he builds chunked, node-based workflows with a human backup at every break point. On making docs AI-readable, his advice is that the craft hasn't changed: plain language, topic-based writing, self-contained pages — and now self-contained paragraphs. \nHe also covers governing decentralised content production, why quality beats speed in AI workflows, and his rapid-fire picks for technical writers. \nThank you for tuning in!   In the meantime, if you're ready to explore Document360, a knowledge base platform that can help your customers and teams get instant answers, we’d love to invite you to try it first-hand.  Simply use this link - https://bit.ly/4ktBnZZ to start your free trial.","thumbnail_url":"https://img.transistorcdn.com/I3uR1xA3Et2H8jv2qpXR7ZbQ4mi8AR5s21zNHZxQ-IU/rs:fill:0:0:1/w:400/h:400/q:60/mb:500000/aHR0cHM6Ly9pbWct/dXBsb2FkLXByb2R1/Y3Rpb24udHJhbnNp/c3Rvci5mbS8xYzlm/ODljN2FkYWE3NDA3/OWY3MzYzMjk2ZWM1/YzdjZC5wbmc.webp","thumbnail_width":300,"thumbnail_height":300}