It would be helpful for the binding conveyance feature of futures, agents and any other places that support it to be more prominent in the doc-strings. It could be as little as a note at the bottom saying something like: "This will propagate current thread's bindings to the new thread."
I have also added an issue to the (link: clojure-site github repo)(https://github.com/clojure/clojure-site/issues/352) to add a note on binding conveyance to the vars reference page on clojure.org.
Patch: clj-2476.patch
