make Clojure's performance philosophy re: collections more evident

[stuarthalloway]

Right now I think this is explained only in the FAQ: https://clojure.org/guides/faq#conj.

Maybe we need a similar sentence or two under data structures: https://clojure.org/reference/data_structures

Or maybe a full-fledged guide that talks in more detail about why this is important, how it motivates both contains? and conj, etc.

[stuarthalloway]

Regardless of who writes this, hours of consideration from multiple people will likely be required before it is finalized.

[puredanger]

I think a guide re collections (starting from something like my http://insideclojure.org/2016/03/16/collections/ - happy to donate that), but also extending to perf etc would be a great addition.

[jafingerhut]

Not sure whether a table like in this article would be of interest for an article on this topic: https://www.innoq.com/blog/st/2010/04/clojure-performance-guarantees/

[puredanger]

I think Stu is referring to the policy in general, not specific expectations. Policy being that operations have performance expectations.