search

scala / scala3

The Scala 3 compiler, also known as Dotty.
https://dotty.epfl.ch
Apache License 2.0
5.82k stars 1.05k forks source link

Online Scala 3 Reference : broken links #14186

Open michelou opened 2 years ago

michelou commented 2 years ago

Markdown document experimental-defs.md is not available as experimental-defs.html in the online Scala 3 Reference; the user gets the error 404 Not Found.

One can see from the contents of the online directory other-new-features/ that the file doesn't exist.

Final notes:

  1. The broken link also appear in the outdated page experimental-defs on the Dotty website (see banner: The content of this page is outdated. Click here to find the up to date version of this page.).
  2. The online directory experimental/ is also missing several HTML pages.
pikinier20 commented 2 years ago

Hmm, I see the document available at: https://dotty.epfl.ch/docs/reference/other-new-features/experimental-defs.html

Maybe I misunderstood the problem?

The document isn't available at docs.scala-lang.org because the documentation was migrated before the document was created. Now, IIRC, the most up-to-date documentation is present at dotty.epfl.ch

som-snytt commented 2 years ago

I stopped landing on dotty.epfl.ch when my previous link https://dotty.epfl.ch/docs/Reference/index.html with capital R stopped working.

The situation is confusing; speaking as a noob contributor with an open doc PR.

For a while, I preferred epfl for the dark theme and I only clicked thru to scala-lang to see if there was new info. (I find the scala-lang theme harsh to read.)

michelou commented 2 years ago

@pikinier20 All files should be available on docs.scala-lang.org now; as stated on the web pages on dotty.epfl.ch/docs/ those pages are outdated (it's unpleasant for Scala developers to reach them).

som-snytt commented 2 years ago

Maybe s/outdated/updated.

michelou commented 2 years ago

@som-snytt I'm sure that in secret you are also a big fan of the PDF version : scala3_reference.pdf (PR#11257). 😉

som-snytt commented 2 years ago

@michelou in fact I was very impressed!

michelou commented 2 years ago

I just updated the PDF file scala3_reference.pdf (PR#11257) which includes the new chapter "Language versions". :grin:

michelou commented 2 years ago

I just updated the PDF file scala3_reference.pdf (PR#11257) which includes the new section "Capture Checking" (in chapter "Experimental", which is not available in the online Scala 3 Reference page).