pedestal

hlship 2025-04-21T22:52:55.074889Z

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.

2025-04-21T23:06:31.955699Z

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

hlship 2025-04-21T23:15:00.134399Z

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.

2025-04-21T23:25:00.807689Z

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.

hlship 2025-04-21T23:26:07.845859Z

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

👍 1