tl;dr:Documenting your codebase doesn’t have to suck. Forget code comments or “self-documenting code”. IDE integrated documentation is slowly becoming one of the most convenient ways to manage knowledge about your codebase and this article explains why.