This is not very surprising. The docs you write can only help if the person who is reading it have the same mental model of what ever thing that is being documented. Because the questons they want answered arises from what ever little subset of understanding they have of the thing. And this could be different for different people.

And this is why LLMs are great for looking up docs. It makes any docs work for any one as long as the information is present in the doc.