Earlier quoted context omitted.
The first three are in English, sure, I'm talking about the last two paragraphs. I understood the problem, almost from the title - I was interested mostly in the proposed solution. In particular, the last 2-3 sentences where a complex procedure is defined in a few inline code snippets - and then the author continues as if the result is obvious. It reminds me very much of when I read overly mathematical scientific pub…
The fact that you're a PhD student might help to explain this. My experience is that most people just won't care, but will be reassured by seeing real code in the text. They will skim without understanding, but getting the idea that there is a concrete process being explained. You (somewhat like me in this instance) will want to understand what's actually happening. For that case the author has in fact provided more…
This reads like a normal human speaking, who was asked a question and elaborated. That's fine.
The problem with the OP's article was that I couldn't skim read it, because the code didn't make obvious sense in a "reading aloud" kind of way. It would have worked much better if the footnote had replaced, or been included as padding around the code. The skim readers would still have been happy, especially if there was a carefully placed paragraph break so they could "skip over the details," and I/we would have been happy too.
Also, two code snippets out of context are anything but real code, at least in my brain :)