Would it make sense to incorporate alpha 2 into a new project? All the documentation I can find right now is the differences to alpha 1. Is it enough to read the docs for alpha 1 and the differences page?

No, you should not use it yet

Unless you enjoy bugs and breaking changes

Ok, good to know, thank you @alexmiller

There are docs at https://clojure.github.io/spec-alpha2/ btw

Honestly, when looking at a library I always look at a high level doc first instead of api documentation. On the other hand, that api doc is very exhaustive 🙂

So thanks for the pointer