scala / bug

Scala 2 bug reports only. Please, no questions — proper bug reports only.
https://scala-lang.org
232 stars 21 forks source link

Existing links to the current version's ScalaDoc are broken in 2.12.0 #10029

Open scabug opened 8 years ago

scabug commented 8 years ago

Existing links to ScalaDoc that target the current version of Scala (i.e. links such as http://www.scala-lang.org/api/current/index.html#scala.Int) now ends up at the ScalaDoc start page instead of the intended sub page (the sample link must instead now be written as http://www.scala-lang.org/api/current/scala/Int.html). This affects many existing links on StackOverflow.com and other sites with Scala-related information. Perhaps a response with a permanent redirect can be returned for any links using the old format so that the user ends up at the correct page.

scabug commented 8 years ago

Imported From: https://issues.scala-lang.org/browse/SI-10029?orig=1 Reporter: Odd Möller (odd) Affected Versions: 2.12.0

scabug commented 8 years ago

@SethTisue said: could you report this at https://github.com/scala/scala-lang/issues please?

sjrd commented 7 years ago

This needs to be fixed in the Scaladoc generation of 2.12. It needs to interpret #-based links and redirect them to the new style. It affects the Scaladocs of all libraries that previously published them from 2.11 and now from 2.12.

For example, the following link: https://www.scala-js.org/api/scalajs-library/1.0.0-M1/#scala.scalajs.js.package should redirect to https://www.scala-js.org/api/scalajs-library/1.0.0-M1/scala/scalajs/js/index.html

https://github.com/scala/scala-lang/issues is not the right place to report this problem. The present issue tracker is.

IMO this issue should be reopened.

szeiger commented 5 years ago

FYI: https://github.com/sbt/sbt-sdlc can now check scaladoc 2.12 links so you can at least identify them for a (manual) rewrite.

SethTisue commented 1 year ago

Is this still an issue in 2.13, or was it truly a 2.12-only situation?