[MikeOfAu]

Thanks for the feedback. In this regard, I think things have improved a little over the last 8 months, stepwise.

In our busy world, people want more immediate summaries and progress. These docs arose out of me trying to teach my team how to think about coding in Clojure and to use re-frame (we were all new to the language at the time), so they definitely have a didactic flavour.

I continue to nudge them in the direction you recommend.