Update Scala documentation for Scala 3

[Nicolapps]

The API documentation for Scala 3 is missing from DevDocs.

The documentation versions report indicates that the Scala documentation is up to date, while it isn’t: the latest scraper version is 2.13.0, while the latest Scala version is 3.1.0.

[simon04]

The latest version is taken from the navbar of https://www.scala-lang.org/api/current/. Scala 3 API docs is hosted at https://scala-lang.org/api/3.x/

@Nicolapps, are you interested in updating (or helping to update) the scraper for Scala 3?

[Nicolapps]

That behavior looks strange to me, I opened an issue (scala/docs.scala-lang#2270) to ask if it is intentional.

I can’t work on this right now, but I could help to update the scraper in the next few months if help is still needed.

[Nicolapps]

I’m currently working on a scraper, I’ll keep you updated!

[thewheat]

I believe this issue can be closed as

• linked PR is merged Add a scraper for Scala 3 #1708
• and there is support for 3.2 and 3.1 (see linked code and screenshot below)

  devdocs/lib/docs/scrapers/scala.rb

  Lines 10 to 60 in 77d7e2e

  	options[:attribution] = <<-HTML
  	&copy; 2002-2022 EPFL, with contributions from Lightbend.<br>
  	Licensed under the Apache License, Version 2.0.
  	HTML
  	# For Scala 3, there is no official download link for the documentation
  	# (see https://contributors.scala-lang.org/t/5537).
  	#
  	# We currently need to build the docs ourselves. To do so:
  	# 1. Make sure that Scala 3 and sbt are installed
  	# (https://www.scala-lang.org/download/scala3.html)
  	# 2. Clone the Scala 3 (Dotty) repository (https://github.com/lampepfl/dotty)
  	# 3. From the Dotty folder, run this command in the terminal:
  	# $ sbt scaladoc/generateScalaDocumentation
  	# 4. Extract scaladoc/output/scala3/api/ into docs/scala~3.1
  	version '3.2' do
  	self.release = '3.2.0'
  	self.base_url = 'https://scala-lang.org/api/3.2.0/'
  	self.root_path = 'index.html'
  	options[:skip_patterns] = [
  	# Ignore class names with include “#”, which cause issues with the scraper
  	/%23/,
  	# Ignore local links to the Java documentation created by a Scaladoc bug
  	/java\/lang/,
  	]
  	html_filters.push 'scala/entries_v3', 'scala/clean_html_v3'
  	end
  	version '3.1' do
  	self.release = '3.1.1'
  	self.base_url = 'https://scala-lang.org/api/3.1.1/'
  	self.root_path = 'index.html'
  	options[:skip_patterns] = [
  	# Ignore class names with include “#”, which cause issues with the scraper
  	/%23/,
  	# Ignore local links to the Java documentation created by a Scaladoc bug
  	/java\/lang/,
  	]
  	html_filters.push 'scala/entries_v3', 'scala/clean_html_v3'
  	end
  	# https://downloads.lightbend.com/scala/2.13.0/scala-docs-2.13.0.zip
  	# Extract api/scala-library into docs/scala~2.13_library
  	version '2.13 Library' do
  	self.release = '2.13.0'

[Nicolapps]

That’s correct, #1708 resolved this issue.