scala / scala-lang

sources for the Scala language website
https://scala-lang.org
Other
270 stars 321 forks source link

Nightly docs for 2.13 unlinked; 2.12 and 2.13 nightly docs are outdated #929

Closed Blaisorblade closed 9 months ago

Blaisorblade commented 6 years ago

@SethTisue asked for a ticket on Gitter, here it is.

SethTisue commented 6 years ago

labeled "good first issue" since the first bullet should be a quick fix. we can remove the label if just that part gets fixed

SethTisue commented 6 years ago

as for the second bullet, the 2.13 docs shown are from January 31, 2018, which iirc correctly is around when we moved publishing of nightlies off Jenkins and onto Travis-CI. 2.12 is affected equally.

I see from looking at https://scala-ci.typesafe.com/view/scala-2.12.x/job/scala-2.12.x-release-website-update-api/ that the script that used to actually do the work is scripts/jobs/release/website/update-api in https://github.com/scala/scala-dist . @lrytz I guess this was an oversight that that script apparently isn't wired up right anymore...?

although the API docs are published to scala-lang.org, the repo where this problem is actionable is actually https://github.com/scala/scala; the .travis.yml there needs updating to do the job that https://scala-ci.typesafe.com/view/scala-2.12.x/job/scala-2.12.x-release-website-update-api/ used to do. looking at that Jenkins job, it seems that scripts/jobs/release/website/update-api in the scala/scala repo is where the actual work was done. (looking at scripts/travis-publish-spec.sh might be relevant too.)

SethTisue commented 9 months ago

I don't think we still have a goal of publishing Scaladoc for nightlies, since it doesn't change that often.

Maybe Scala 3 does it? Not a goal for Scala 2, in any case.