Clojurians Log v2
pedestal
Hey folks! Working on the Pedestal docs can be fun. The Antora tools make it fast and pretty. It’ll always be more work than any one person can dedicate, and it’s an easy way to contribute. https://github.com/pedestal/pedestal-docs has the details.
reviewplease https://github.com/pedestal/pedestal/pull/869 This is a lot more refactoring of pedestal.route, simplifying a lot of things, patching up others. The main bit is that you can now invoke route/expand-routes with multiple route specifications and it will merge it all together. They don’t even have to be the same format (i.e., some table, some terse).
There’s some backwards compatibility issues if you ever implemented the Router or ExpandableRoutes protocols (the later is what auto-magically interprets a hash map as table routes). I haven’t found an example of that out in the world, so, hey, 0.8 is still alpha, right?
I'm kind of happy to see the PR. The old routing protocols looked very strange and incomplete. I tried to use/extend it once and failed.
I searched GitHub for use of the protocols; outside of pedestal forks, I couldn't find anything. Retit doesn't use Pedestal's interceptor or protocols, it provides its own.
There's still a couple of more phases of cleanup.
I think Pedestal also would have been well served, when the code was first put together, with a glossary of terms. There's so many "specifications".