Restructure the top-level doc pages to better highlight the new tutorials.

Author: sjrd

_data/doc.yml

@@ -1,12 +1,14 @@
-- text: Introduction
+- text: Documentation
   url: /doc/
-#- text: Quick Start
-#  url: /doc/quick-start.html
 - text: Tutorials
   url: /doc/tutorial/
   subitems:
-    - text: Basic tutorial
-      url: /doc/tutorial/basic/
+    - text: Getting Started with Scala.js and Vite
+      url: /doc/tutorial/scalajs-vite.html
+    - text: Build UIs with Laminar
+      url: /doc/tutorial/laminar.html
+    - text: Integrate JavaScript libraries with ScalablyTyped
+      url: /doc/tutorial/scalablytyped.html
 - text: Scala.js for JavaScript developers
   url: /doc/sjs-for-js/
   subitems:

doc/index.md

@@ -1,29 +1,24 @@
 ---
 layout: doc
-title: Introduction
+title: Documentation
 ---
 
-The bullets on the right link to various facets of the documentation.
+# Getting Started
 
-If you are coming from a JavaScript background, we've got
-[a special tour for you](sjs-for-js/), which will teach you the basics of
-Scala.js with respect to JavaScript.
+Follow our [Getting Started Tutorials](tutorial/).
 
-# Installation
+# Installation / Download
 
-All you need to get started is 
+One does not install or download Scala.js.
+It is automatically handled by build tools.
 
-* A recent version of Java JDK [(download)](https://www.oracle.com/java/technologies/downloads/)
-* SBT [(download)](https://www.scala-sbt.org/1.x/docs/Setup.html)
+If in doubt, follow the [Prerequisites](tutorial/#prerequisites) section of the Getting Started Tutorials.
 
-See the [Basic tutorial](tutorial/basic/) for details about installation and setup.
+# Other resources
 
-# Tutorials
-
-Check out one of the [tutorials](tutorial/) to continue your journey!
-
-You may also find the [presentation videos](../community/presentations.html)
-a nice way to get started with Scala.js!
+* [Presentation videos](../community/presentations.html)
+* [Tour of Scala.js for JavaScript developers](sjs-for-js/)
+* More in the column on the right of this page
 
 # Get help
 

doc/tutorial/getting-started/index.md

@@ -3,11 +3,51 @@ layout: doc
 title: Tutorials
 ---
 
-Arguably, the most efficient way to learn new technology is to try it out yourself. Here, we have collected a set
-of tutorials from simple to complete web app, to get you started right away!
+This series of tutorials teaches you how to use Scala.js together with modern development tools.
 
-* [Getting Started with Scala.js, Vite, Laminar and ScalablyTyped](./getting-started/)
-* [Basic tutorial](./basic/) to get you started
+1. [Scala.js and Vite](./scalajs-vite.html):
+  * Set up a hello world project ready for live reloading in the browser.
+  * Generate minimized production assets.
+2. [Laminar](./laminar.html):
+  * Build UIs with Laminar using Functional Reactive Programming (FRP), a hybrid model between imperative and functional programming particularly well suited for UI development in Scala.
+3. [ScalablyTyped](./scalablytyped.html):
+  * Integrate JavaScript libraries using ScalablyTyped.
+
+If you have time, reading and applying them in order will give you more in-depth knowledge about the development environment.
+
+If you are in a hurry, you can skip the ones you are not interested in.
+Each tutorial starts with a link to a repo that you can clone to get off the ground.
+
+In any case, make sure that you have the prerequisites listed below covered.
+
+## Prerequisites
+
+In any case, make sure that you have the following tools installed first:
+
+* [Scala and its development tools](https://www.scala-lang.org/download/)
+* [Node.js](https://nodejs.org/en/download/)
+
+If in doubt, try the following commands in a terminal.
+They should all succeed, though the reported version numbers may differ.
+
+{% highlight shell %}
+$ node -v
+v16.13.0
+$ npm -v
+8.1.0
+$ sbt -version
+sbt version in this project: 1.7.3
+sbt script version: 1.7.3
+{% endhighlight %}
+
+We also recommend that you use an IDE for Scala.
+If you do not know what to pick, we recommend [VS Code](https://code.visualstudio.com/download/) with [the Metals extension](https://scalameta.org/metals/docs/editors/vscode/).
+
+## Older tutorials
+
+Here are some older tutorials, which may still provide value:
+
+* The old [basic tutorial](./basic/)
 * [Hands-on Scala.js](https://lihaoyi.github.io/hands-on-scala-js), an extensive tutorial in eBook format
 * [SPA tutorial](https://github.com/ochrons/scalajs-spa-tutorial) for writing a
   Single-Page-Application using React

doc/tutorial/index.md

@@ -1,6 +1,6 @@
 ---
 layout: doc
-title: Getting Started with Laminar
+title: Build UIs with Laminar
 ---
 
 In this second tutorial, we learn how to develop UIs in Scala.js with [Laminar](https://laminar.dev/).

doc/tutorial/getting-started/laminar.md renamed to doc/tutorial/laminar.md

@@ -1,6 +1,6 @@
 ---
 layout: doc
-title: Getting Started with ScalablyTyped
+title: Integrate JavaScript libraries with ScalablyTyped
 ---
 
 In this third tutorial, we learn how to integrate JavaScript libraries with [ScalablyTyped](https://scalablytyped.org/).