Jetty.project: Each 9.4.x maintenance release breaks links to preceding version's documentation

[wilkinsona]

A Spring Boot user has reported a problem with Spring Boot's reference documentation linking to Jetty's documentation. Spring Boot's reference documentation links to the Jetty documentation for the specific version of Jetty that it built against. For example, the documentation for Spring Boot 2.2.4 links to https://www.eclipse.org/jetty/documentation/9.4.25.v20191220. Unfortunately, this link is now broken. As far as I can tell, the breakage occurred when 9.4.26 was released as its documentation replaced the documentation for 9.4.25.

I'm aware of the 9.4.x link but this points to snapshot documentation which we'd prefer not to use. I'm also aware of the current link, but this will, presumably, eventually link to 9.5.x or 10.x so it will become inaccurate over time.

Would it be possible to avoid breaking links by publishing new documentation in addition to rather than in place of the existing documentation. Failing that, would it be possible to provide a link for 9.4 that points to the latest release rather than the latest snapshot?

[joakime]

We have a "current" at https://www.eclipse.org/jetty/javadoc/current/
But that's not enough detail. Especially as we are working towards Jetty 10.x (Jakarta EE 8 based) and 11.x (Jakarta EE 9 based) atm.

[WalkerWatch]

@wilkinsona Let me discuss with @jmcc0nn3ll. I think the idea has merits, as I know other projects in addition to Spring link to our documentation. We would need to create something like /documentation/9.4.x/ for each major release version, in addition to /documentation/current, which should be feasible.