Documentation headaches. There’s now two main ways of doing things, io.pedestal.http (through 0.7) and io.pedestal.connector (in 0.8). I think we’re definitely getting to the stage when io.pedestal.http needs to be deprecated and the documentation split up in some way. Right now, everything is coming out in doublespeak.
I notice there's a version number in the URL! https://pedestal.io/api/0.8/ and https://pedestal.io/pedestal/0.8/index.html etc., so I would vote, if this is the question, for just not mentioning the 0.7 way on the 0.8 pages
Yes, that’s the advantage of Antora, and if io.pedestal.http was deprecated, we could short change it’s discussion in 0.8 docs and point towards 0.7.
I hope it's not going to be removed, though. "Not updating" Pedestal is easy for a while, but then there's a major new Jetty and you can't avoid it.
I described things more completely here: https://github.com/pedestal/pedestal/issues/912 • Deprecate io.pedestal.http • Provide a different solution for WAR files that builds on io.pedestal.connector