Threading macros - an idiom for applying them

Idiom for general use

-> for collection functions
->> for sequence functions

Sequence functions accept a sequence as the last argument of the function call, so thread with ->>

Collection functions accept the collection as the first argument, so thread with ->

Nesting threading macros - usually avoid

->> and as-> can be nested inside ->
but you can't nested those inside ->> so if you ever need a "mixed" pipeline, start with ->:

(-> data
    (->> (map my-function)
         (filter my-predicate)
         (reduce reducing-function initial-value))
    (as-> value (do stuff to value with args))
    (process with some args))

Mixed pipeline should generally be avoided as it indicates the value is "changing shape". The above would be better broken into smaller pieces, eg. with a let expression.

No documentation file or test is named in the issue. Start by locating the project's documentation on Clojure threading macros, then add the idiom and nesting guidance from the issue; done means the guidance is included in the appropriate documentation location and renders correctly.