What Scala version should we show in docs and examples?

[raboof]

For example in https://pekko.apache.org/docs/pekko/current/typed/guide/tutorial_1.html and the quickstart projects, what Scala versions should we show?

For the docs: the maven snippet in https://pekko.apache.org/docs/pekko/current/typed/guide/tutorial_1.html still shows Scala 2.13, I think we should probably show 3.x. I don't think we use the full Scala version in docs very often.

For the quickstarts: since here the target audience is mainly application authors, showing the latest Scala release (rather than the latest LTS) might make most sense?

[raboof]

It seems the voting system doesn't show who voted what :/ .

FWIW I voted "The latest" - while we should definitely support older versions, I don't think it makes sense to recommend them for new users. Users that just "go with the flow" should be on the latest versions, users that have particular reasons to stick with older versions are probably mature enough to adapt quickstarts/docs to their needs.

The only reason I can think of to stick with older versions is when the quickstarts also double as tests, and of course we want to make sure our code still works with the minimum still-supported version. I don't think we should (ab)use quickstarts for that, though.

[pjfanning]

• 2.13 is by far the most used by Pekko users based on repository.apache.org stats
• I guess it doesn't matter too much as long as it is easy for users to switch to a scala different version
• maybe we need better testing of our g8 templates to ensure that they work with different scala versions