Share your thoughts in the 2024 State of Clojure Survey!

Welcome! Please see the About page for a little more info on how this works.

0 votes
in Docs by

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.

1 Answer

0 votes
by
Reference: https://clojure.atlassian.net/browse/CLJ-1913 (reported by alex+import)
...