3.5.2 and 3.6.0-RC1 release procedure

[WojciechMazur]

Publish 3.5.2 artifacts to Maven Central via CI

• On release-3.5.2 branch
  • In Build.scala: Set baseVersion to 3.5.2
  • In TastyFormat.scala: Set ExperimentalVersion to 0
  • In changelogs add file with a changelog
• Tag the branch as 3.5.2
• Wait for CI to publish artifacts

Publish 3.6.0-RC1 artifacts to Maven Central via CI

• On release-3.6.0 branch
  • In Build.scala: Set baseVersion to 3.6.0-RC1
  • In Build.scala: Set referenceVersion to 3.5.2
  • In changelogs add file with a changelog
• Tag the branch as 3.6.0-RC1
• Wait for CI to publish artifacts

Set bootstrapping for future versions version on main

• In Build.scala: Set referenceVersion to 3.6.0-RC1:
• Check and update project/MiMaFilters.scala

Confirm that the tooling is working correctly

• Metals:
  • 3.5.2
  • 3.6.0
  • 3.6.1
• Scala Native:
  • 3.5.2
  • 3.6.0
  • 3.6.1
• Scastie:
  • 3.5.2
  • 3.6.0
  • 3.6.1
• Scala DAP:
  • 3.5.2
  • 3.6.0
  • 3.6.1
• Scala CLI:
  • 3.5.2
  • 3.6.0
  • 3.6.1

Prepare the documentation

• Publish API docs for 3.5.2
• Add 3.5.2 to the version list in API docs
• Set 3.5.2 as default target for 3.x and current docs versions
• Publish API docs for 3.6.1
• Add 3.5.2 to the version list in API docs
• Update docs.scala-lang Add Scala 3.5.2 to API docs docs.scala-lang#3093

Announce the releases

• Make all GitHub releases public:
  • 3.5.2
  • 3.6.0
  • 3.6.1
• Publish an announcement on https://scala-lang.org Add Scala 3.5.2 announcement scala-lang#1707
• Update the 3.5.2 tracking thread on https://contributors.scala-lang.org
• Open 3.6.0 tracing thread on https://contributors.scala-lang.org https://contributors.scala-lang.org/t/scala-3-6-release-thread/6796

Update the ecosystem

• Release 3.5.2 to SDKMAN
• Release 3.5.2 to Chocolatey
• Update the templates and examples projects:
  • scala3-mill-example-project Update Scala version to 3.5.2 scala3-mill-example-project#25
  • scala3-cross.g8 Update Scala version to 3.5.2 scala3-cross.g8#114
  • scala3-staging.g8 Update Scala version to 3.5.2 scala3-staging.g8#57
  • scala3-tasty-inspector.g8 Update Scala version to 3.5.2 scala3-tasty-inspector.g8#53
  • scala3.g8 Update Scala version to 3.5.2 scala3.g8#152
• Unlock Scala Steward updates Unlock Scala 3.5.2 updates scala-steward-org/scala-steward#3451

[WojciechMazur]

Because of error during the release we published 3.6.0-RC1 as 3.6.0 to Maven central. These artifacts cannot be removed.
To mitigate potential damage (3.6.0 artifact produced TASTy in experimental mode) we shipped 3.6.1 based on 3.6.0-RC1 state but with stable TASTy.

During Scala 3.6 RC period release 3.6.1 should be treated as 3.6.0-RC1.
If for some reason during the remaining 5 weeks of RC period there would be no need for any important backports we'd announce 3.6.1 as the first release of Scala 3.6
Otherwise, we would include required changes in Scala 3.6.2 and announce it as first stable release of Scala 3.6. It would involve releasing 3.6.2-RC versions as well.