Document namespaces in order of usage

[kurtharriger]

The namespaces appear to be ordered arbitrarily, it would be more useful if the namespaces were ordered so that the dependencies come first (or possibly last depending on your preference). I recently created a leiningen plugin around a project that creates an acyclic dependency graph from the namespace imports which might be useful for ordering the namespaces: https://github.com/kurtharriger/clojure-dependency-grapher

[Engelberg]

I think ultimately, you want to give the author complete control over the order of the namespaces. Would like to be able to order them in a way that helps the code read like a story.

[algernon]

For the record, it is possible to order namespaces in the order you like. I've been doing that on a project of mine (result here), and while it's not the most convenient or automatic thing, it is doable.