Online Scala 3 Reference : broken links

[michelou]

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]

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]

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]

@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]

Maybe s/outdated/updated.

[michelou]

@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]

@michelou in fact I was very impressed!

[michelou]

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

[michelou]

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).

[som-snytt]

I just hit this particular bad link.