You're very much taking that out of context. Read the entire section. There's a grand total of 7 sentences in there. It literally says: If you're going to have

You're very much taking that out of context. Read the entire section. There's a grand total of 7 sentences in there. It literally says: If you're going to have to explain it at the next code review, you should comment it now. Complicated operations get a few lines of comments before the operations commence. Non-obvious ones get comments at the end of the line. The section you're quoting says: On the other hand, never describe the code. Assume the person reading the code knows Python (though not what you're trying to do) better than you do.