Code is not documentation: How to document software properly | Milana Cap (XWP)
Episode notes
In this episode of The Melapress Show, Robert Abela speaks with Milana Cap, WordPress Documentation Team representative and WordPress Engineer at XWP, about the role documentation plays in building and maintaining software.
The conversation explores why documentation is often neglected, why code reference alone is not enough, and why useful documentation needs to be treated as part of the product and development process.
Milana also shares practical ideas for documenting decisions, maintaining documentation over time, and making the work manageable for smaller teams. She explains how the WordPress Documentation Team approaches release documentation and discusses the limits and opportunities of AI in documentation workflows.
The episode also covers her Doc2Me project, which aims to help developers identify and structure the documentation that needs to be written.
Key topics include:
▫️ Why code is not the same as complete documentation
▫️ Why documentation should be part of development
▫️ How to record decisions and reduce future confusion
▫️ How WordPress handles documentation during release cycles
▫️ Where AI can support documentation work
▫️ The idea behind the Doc2Me project
🎙️Guest: Milana Cap, WordPress Documentation Team representative and WordPress Engineer at XWP
🎙️Host: Robert Abela, Melapress