-
we use clojure metadata to tag a function as an example for another function, and the doc generator matches them up
-
benefits over examples in docstrings: - avoids cluttering up core code - we can use paredit etc - the compiler will check our example code!
