Scala 3 reference docs for 3.2.0 do not have updated sources

[bishabosha]

as of 18 October 2022 https://docs.scala-lang.org/scala3/reference/language-versions/source-compatibility.html looks like:

it should show content as listed in https://github.com/lampepfl/dotty/blob/release-3.2.0/docs/_docs/reference/language-versions/source-compatibility.md

[bishabosha]

according to @julienrf release-3.2.0 should be merged into language-reference-stable

[julienrf]

I think there is a general lack of clarity about how the various docs are generated.

As far as I understand, we have:

• https://scala-lang.org/api/3.x (which is generated by VirtusLab publishing some files on an EPFL-owned server)
• https://docs.scala-lang.org/scala3/reference (which is generated by EPFL, by pulling the content of https://github.com/lampepfl/scala3-reference-docs, which is itself generated automatically from the content on this repository on branch language-reference-stable)
• https://dotty.epfl.ch (nightly documentation)

Correct me if I am wrong, and please document those things here (in CONTRIBUTING.md?), and explain the policies regarding what goes into what branch (if I want to fix something in the documentation, should I target main or language-reference-stable?).

Last, make sure the release procedure takes all those forms of documentation into account (currently, it seems only the API documentation is updated during the release process, but you should also merge the content of the main branch to language-reference-stable before the release)

[bishabosha]

Last, make sure the release procedure takes all those forms of documentation into account ... but you should also merge the content of the main branch to language-reference-stable before the release)

I think you mean the current release branch? - main branch might have documentation for unreleased new features

[julienrf]

I think you mean the current release branch? - main branch might have documentation for unreleased new features

Yes.

[bishabosha]

Changes are now visible on the website