Two issues regarding the documentation of core.reducers
There is a contradiction between the documentation mentioned in (link: http://clojure.github.io/clojure/clojure.core-api.html#clojure.core.reducers/fold), with respect to the one mentioned here (link: http://clojure.org/reference/reducers). Specifically on the line that states "(with a seed value obtained by calling (combinef) with no arguments)" on the former and "The reducef function will be called with no arguments to produce an identity value in each partition." on the later. Those two documentation references are contradictory. Either combinef is called with no arguments or reducef is called with no arguments.
The second doc issue is regarding the arities of most functions in core.reducers. With the introduction of transducers in Clojure 1.7. The single arity in functions like r/map or r/filter gives the impression that they return a transducer, whereas they just return a curried version of them. Nothing in the docstrings or the reference page mentions what is the return value of those functions with a single argument.
