Comments also need: The CONTEXT, often non-assertable non-functional assumptions. The WHY NOT, the non-obvious omissions, because code that isn't there cannot

Comments also need: The CONTEXT, often non-assertable non-functional assumptions. The WHY NOT, the non-obvious omissions, because code that isn't there cannot be self-documenting.