Programming

You want to turn my 300 lines of clear, readable and concise logic into 1,000 lines of English paragraphs that break up the functions of my code into yet smaller pieces of code devoid of context?

If a function has 300 lines without a lot of supporting documentation then I doubt that it is "clear, readable and concise" anyway.

Now I have to dig through that book, ignoring all the shit I’ve read hundreds of times because it doesn’t compile into anything, just to debug an off-by-1 error in a loop buried in a paragraph explaining the original developers diatribe on why we’re looping over that range?

I have never found it hard at all to skip past comments that are not relevant because my code editor helpfully colors them differently from the rest of the code, making it easy. Does your editor not do the same?

(Also, by now you should be especially good at skipping past it, given that you have apparently "read [it] hundreds of times" instead of skipping past it, for some reason.)

This is the sort of academic crap that sounds good but in practice is just terrible for anything other than small projects that are intended specifically to teach.

It depends on what you are doing. If you are implementing relatively simple logic like a REST API handler, then it is probably overkill. If you are implementing a relatively advanced algorithm, then having a running narrative of what is going can be extremely helpful.