> by someone who maybe isn't so great at clear communications

I don't think that's fair. If you're familiar with the programming language, his writing is fairly clear. If you're not, maybe you're just not in his target audience.

IOW, optimizing his text for people familiar with the language is probably a better choice than teaching the language, which would distract him from his goal.