Website has many broken links

[binary132]

Hello,

I've been trying to investigate the state of Scala 3 metaprogramming, and unfortunately there are quite a few 404's in the Dotty web docs, particularly in Overview, where I'm very surprised to see the documentation of a very significant public-facing project in such a poor state of maintenance.

One of the most important (to me) is that https://dotty.epfl.ch/docs/reference/overview.html contains broken references to "Principled Metaprogramming" at https://dotty.epfl.ch/docs/reference/principled-meta-programming.html. Other broken links in the landing page include:

• "inline": https://dotty.epfl.ch/docs/reference/inline.html
• "intersection types": https://dotty.epfl.ch/docs/reference/intersection-types.html
• "implicit function types": https://dotty.epfl.ch/docs/reference/implicit-function-types.html
• "dependent function types": https://dotty.epfl.ch/docs/reference/dependent-function-types.html
• "trait parameters": https://dotty.epfl.ch/docs/reference/trait-parameters.html
• "early initializers": https://dotty.epfl.ch/docs/reference/dropped/early-initializers.html
• "union types": https://dotty.epfl.ch/docs/reference/union-types.html
• "multiversal equality": https://dotty.epfl.ch/docs/reference/multiversal-equality.html
• "type lambdas": https://dotty.epfl.ch/docs/reference/type-lambdas.html
• "type projection": https://dotty.epfl.ch/docs/reference/dropped/type-projection.html
• "erased terms": https://dotty.epfl.ch/docs/reference/erased-terms.html

I'm hopeful for a more coherent future, but this is a bit concerning.

[jducoeur]

Hmm. Looks like the Overview page has fallen behind the times. The pages are all fine from the navigation pane on the left, but the URLs on the front page are all missing the section part of the path...

[godenji]

I reported similar on the Dotty gitter channel a couple of days ago; there's a PR in process that will fix some (all?) of the links.

For now you can view documentation on new scala macros here:
http://dotty.epfl.ch/docs/reference/other-new-features/principled-meta-programming.html

[binary132]

Good to know, thanks!

[smarter]

I'm very surprised to see the documentation of a very significant public-facing project in such a poor state of maintenance.

This should tell you we need more help, PRs fixing links are more than welcome :).

[binary132]

I had assumed it was just a bunch of outdated broken stuff rather than a mv into a subfolder. 😅

[SethTisue]

maybe someone™️ would like to bring the htmlproofer stuff over from https://github.com/scala/scala-lang