I&#x27;ve seen surprising pushback from non-technical managers over tree-structured information -- we&#x27;re talking something as simple as a three-level nested markdown document. They&#x27;ll say things like &#x27;I can half understand it but <i>my</i> boss won&#x27;t make the effort&#x27;.<p>If you think about how much energy your brain takes to unpack paragraph text into information, tree-structure should be clearer because visual boundaries correspond to topic &#x2F; semantic boundaries, i.e. the brain can offload some parsing to the highly-evolved retina.<p>I don&#x27;t have a good explanation for the preference for paragraph format in docs.