I think the process of peer review often causes papers to be optimized for being hard to critique rather than easy to understand. I have myself participated in writing papers where we decided to leave out some non-crucial but very useful detail just because it opens up too many questions and opportunities for critique.