Comment by Retr0id
A lot of writing suffers from the problem of "this explanation only makes sense if you already understand it", and I think it's the default - if the author is essentially explaining the problem to themselves, of course it makes sense to someone who already understands it.
The problem can be perpetuated when e.g. a lecturer sets recommended reading to students. From the lecturer's perspective the selected reading material has clear explanations (because the lecturer understands the subject well), but the students do not feel the same way.
As you say, this takes effort to overcome, both on the author's side and from anyone trying to curate resources - including what we choose to upvote on HN!
Sadly many Universities have lots of professors who just copy books in the blackboard. Those books that asume you already know.