[willjp]

I think it helps if you can preface your paragraph with a short summary.

The reader then knows generally the scope of what you are trying to communicate, and the details become more approachable. That said, I’m pretty horrible at this balance as well, and often lean towards long form “walls of text” that eat office hours, then work OT to compensate.

[luckylion]

The short preface is a good point. Maybe it could even get expanded in more dynamic elements. Basically a short recap with the ability to quickly dive in deeper if interested, so everyone can choose their level of detail, or glance over it, and only drill down if something stands out to them.

I'll need to see whether our systems supports it.