scala-lang icon indicating copy to clipboard operation
scala-lang copied to clipboard

Canonical link to the latest language specification

Open adamvoss opened this issue 8 years ago • 3 comments

As a user, I want persistent urls to the latest version of the Scala Language Specification so that I can easily find it and when needing to look into behavior.

Finding the latest Scala specification is hard. It cannot be found from search (without leaving the first page or results anyway). The explicit search of "scala language specification 2.12" suggests that I want "scala language specification 2.11" and displays 2.11 as the top result.

I think this issue would be resolved (in time) if there were a persistent path that always held the latest spec and would be referenced (linked) by things that just needed "a" Scala language specification. The existing "versioned" paths would persist for when needing to look into a specific (previous) version.

adamvoss avatar Jan 05 '17 22:01 adamvoss

Finding the latest Scala specification is hard

fwiw, the path I use is: go to scala-lang.org; click "Documentation"; click "Specification"; done.

One idea, not necessarily the only or best idea: what if all of the versions of the spec, at the top where the version number is, had a switcher where you could easily switch to any other version? That would help a great deal with the stale link problem.

PRs welcome!

SethTisue avatar Jan 09 '17 20:01 SethTisue

fwiw, the path I use is: go to scala-lang.org; click "Documentation"; click "Specification"; done.

but... but... if Google can't find it can't be real 😋

(On a serious note: my steps are actually: got to scala-lang.org; click "Language Specification"; done. 🙃 Easy enough once you know the link is there. When someone doesn't, chances are good they will search.)

adamvoss avatar Jan 09 '17 21:01 adamvoss

these days the top hit for "scala language specification 2.13" is what we'd hope, namely https://scala-lang.org/files/archive/spec/2.13/

my own way of getting there these days is: https://sca.la/spec

SethTisue avatar Aug 26 '23 01:08 SethTisue