> it doesn't tell you why the code exists in the first place, or what the code should do This is one of the worst things in most codebases I see. Today I was t

> it doesn't tell you why the code exists in the first place, or what the code should do This is one of the worst things in most codebases I see. Today I was told to use function X to solve my problem. Checked: 0 docs on what it does and why/how; although used extensively in the codebase. Read existing code and try to infer it, every damned time.