Comment by Yatsui

"Helpful to the writer, useless to the reader" is such a good way to put it. The cost just moved downstream. I've started skipping the doc entirely and just reading the code, feels faster at this point