Open adamvoss opened 7 years ago
SethTisue
commented
7 years ago 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!
adamvoss
commented
7 years ago 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.)
SethTisue
commented
1 year ago 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
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.