Yes, my favorite codebase to work in is one full of accurate and long comments that detail that making a function call it never called would cause problems because of the details of a function that gets called 3 layers deeper.