Explain version choice on download page

[majk-p]

This is a follow up to #1790

Last year the advisory board has accepted https://github.com/scalacenter/advisoryboard/blob/main/proposals/032-scala-version-guidance.md that was later marked as completed in scalacenter/advisoryboard#164 by the introduction of https://scala-lang.org/development. While this page provides a clear guidance, it's very hard to find.

The proposal mentioned explaining version choice on the download page, this PR provides such guidance.

[bishabosha]

this perhaps can display the current LTS/Next version?

[majk-p]

That's a good idea, I'm not sure how to implement it with this templating engine though 😞

[bishabosha]

its using jekyll for templating, (like ruby, variables magically exist when you define them)

maybe you can look at this snippet (how the frontpage renders the lts and next releases) which loops through all the "current releases" and then when it sees the right release assigns it to the appropriate variable, then you can splice later with {{scala_lts_version}}

scala-lang/_layouts/frontpage.html

Lines 48 to 62 in 37767b2

	{% for release in site.data.scala-releases %}
	{% assign version_slice = release.version | slice: 0, 2 %}
	{% if release.category == 'current_version' %}
	{% if version_slice == '3.' %}
	{% unless release.title contains "LTS" %}
	{% assign scala_next_release = release %}
	{% endunless %}
	{% if release.title contains "LTS" %}
	{% assign scala_lts_release = release %}
	{% endif %}
	{% else %}
	{% assign scala_2_version = release.version %}
	{% endif %}
	{% endif %}
	{% endfor %}

[majk-p]

Thank you Jamie, that helped! the updated layout renders version numbers as on this screenshot:

@lrytz it also removes the sethian parentheses 😉

[bishabosha]

nice!

[lrytz]

Mabye without the sethian parentheses?

[majk-p]

Sounds good to me

Suggested change

	<li><strong>Scala LTS</strong> - Advised to be used for publishing <strong>libraries</strong>. (Some especially conservative users might also choose it over Scala Next.)</li>
	<li><strong>Scala LTS</strong> - Advised to be used for publishing <strong>libraries</strong>.</li>