I think the docs for reify says a lot about how but misses the point for what "reify" does.
Proposed: Add a definition of what reify does:
Patch: clj-2488-2.patch
Screened by: Alex Miller
Added -2 patch with a small rewrite, retained attribution.