search

typelevel / cats

Lightweight, modular, and extensible library for functional programming.
https://typelevel.org/cats/
Other
5.2k stars 1.19k forks source link

Very old scaladoc on typelevel.org #4369

Open Jasper-M opened 1 year ago

Jasper-M commented 1 year ago

The cats website now points you to javadoc.io for accessing the scaladoc. However you can also still access https://typelevel.org/cats/api/cats/index.html which gives you all the docs for some very old version. That page is also the second search result that google gives me for cats scaladoc.

armanbilge commented 1 year ago

In theory we can delete those old scaladocs (bdac30a3981e027fe49ce0b9dff54db01bf98581), but it may break some inbound links ...

Jasper-M commented 1 year ago

Perhaps you could adapt the redirect rule from

cats/api -> https://www.javadoc.io/doc/org.typelevel/cats-docs_2.13/latest

to

cats/api/$path -> https://www.javadoc.io/doc/org.typelevel/cats-docs_2.13/latest/$path

Or at least add some warning header over every page that points out that you're looking at outdated documentation.

But I don't know if there's an easy way to do either of these things with gh-pages other than editing every html page under cats/api/.

Jasper-M commented 1 year ago

That page is also the second search result that google gives me for cats scaladoc

I can't be the only person who keeps falling into this trap... Is there at least some way to stop search engines from indexing the old scaladoc?