Code is not documentation: How to document software properly | Milana Cap (XWP)

Documentation is often treated as something to do at the end. In this episode of The Melapress Show, Robert Abela speaks with Milana Cap, WordPress Documentation Team representative and WordPress Engineer at XWP, about why that approach creates problems for developers, teams, and users. Milana explains why code alone is not enough, why good documentation is never really finished, and how teams can make documentation a more natural part of the development process. We also look at how the WordPress project handles documentation during release cycles, where AI can help, and where it still falls short. We cover: ▫️ Why “the code is documentation” is only partly true ▫️ Why documentation should be part of development, not an afterthought ▫️ How to document decisions so future work is easier ▫️ How the WordPress Documentation Team manages release documentation ▫️ Where AI can help with documentation workflows ▫️ Milana’s Doc2Me project and the idea behind it This episode is for WordPress plugin developers, product teams, agencies, technical writers, and anyone who wants to build better documentation around software. 📒 Show notes links: ▫️ WordPress Security Survey 2026: https://melapress.com/wordpress-secur... ▫️ Doc2Me project: https://github.com/Doc2Me ▫️ WordPress Documentation Team: https://make.wordpress.org/docs/ 🔉 Learn more about Milana Cap: 🔗 LinkedIn:   / milanacap   🔗 Personal website: https://developerka.org/ 🔗 XWP agency: https://xwp.co/ 🔉Learn more about the host: Robert Abela is the founder and CEO of Melapress, where he leads the company’s strategy and supports the team behind its WordPress security and management tools. A security professional with 23+ years of experience in IT and software, Robert has held management positions at security companies including GFI Software, Acunetix, and Netsparker. He hosts The Melapress Show, featuring expert interviews, Q&A sessions, and practical discussions on WordPress security, user management, compliance, and more. 🔗Robert Abela:   / robertabela   🔗Melapress website: https://melapress.com 👍 Like, comment, and subscribe for weekly conversations on WordPress security, ethical hacking, and developer best practices. #WordPress #Documentation #SoftwareDevelopment #TechnicalWriting #WordPressDevelopment