Akka-http: Broken documentation links when trying to access the latest version

[WadeWaldron]

I attempted to visit this page:

http://doc.akka.io/docs/akka/2.4.9/scala/http/client-side/request-level.html

It gives me the warning that this is not the latest version and has a link to the latest version which is:

http://doc.akka.io/docs/akka/2.4.17/scala/http/client-side/request-level.html

This link is broken. I get a 404 when I follow it.

[jlprat]

Documentation for Akka HTTP is now independent from the Akka one. The new location is http://doc.akka.io/docs/akka-http/current/

[WadeWaldron]

Seems like these broken links are a problem. Google takes me to the old version, and the redirects to the new version aren't helpful. Is closing this issue the right approach here?

I realize the documentation has moved. But if people can't find the new documentation because the Google is still directing them to old versions, and the redirects don't work properly, then how are people going to find what they are looking for?

[johanandren]

I think we need to fix that old-docs-javascript somehow to deal with the akka-http-move.

[jlprat]

Wouldn't that be part of akka/akka then?

[jlprat]

Sorry for the quick finger closing.

[johanandren]

I'm not quite sure where that script lives, yes, probably in the old akka docs, so we'd have to go back and update or something. I think @ktoso knows best how it works.

[ktoso]

Correct, this should be in akka/akka and yes we will fix it during the new-docs work.
It is not possible to automagically make all things work, we will have to spend some time on prepping scripts and sed-ing entire docs codebases.

[ktoso]

Closing and opening in the in Akka as that's where where effort really starts.

[ktoso]

https://github.com/akka/akka/issues/22659

[jonas]

@ktoso I suggest we also close this one as duplicate of the akka/akka one: #809

[ktoso]

Yeah, let's