I totally agree with this. Good codebase evolves all the time thru constant refactoring. Looking after code documentation in this context is a pain. Complex al

I totally agree with this. Good codebase evolves all the time thru constant refactoring. Looking after code documentation in this context is a pain. Complex algos should be covered by tests and not so much by comprehensive documentation. Code documentation works well on external API, which is meant to be relatively static.