Org-mode's modest popularity has always struck me as akin to HTML's in the
90s. It was a way for non-programmers to feel like they were programming.
Never found much of an advantage for it over a plain text file, despite having
tried.
I am fairly sure I tried harder than you, just a hunch.
It's a hyper-specified case indeed that a neophyte couches a code snippet in
prose English to better understand it later. He'll go back to that doc as
often as I go back to my high school notes, and he'll find the prose English
incomprehensible (code comments generally only make sense to the author at
the time they were written. Cite a longwinded comment he made a year ago and
ask him to explain it -- he can't).