clojure
make Clojure's performance philosophy re: collections more evident
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.
Regardless of who writes this, hours of consideration from multiple people will likely be required before it is finalized.
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.
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/
I think Stu is referring to the policy in general, not specific expectations. Policy being that operations have performance expectations.