NIT refactor docs

- apply the `ChainedSnippets` component where applicable
- update deprecated behaviours

Author: Gedochao

website/docs/commands/basics.md

@@ -3,6 +3,8 @@ title: Basics
 sidebar_position: 3
 ---
 
+import {ChainedSnippets} from "../../src/components/MarkdownComponents.js";
+
 Scala CLI is a command line tool that executes a given sub-command on the inputs it’s provided with, using a
 given [configuration](../guides/configuration.md) to produce a result.
 
@@ -60,11 +62,18 @@ object Hello {
 
 Then run it by passing it to `scala-cli`:
 
+<ChainedSnippets>
+
 ```bash
 scala-cli Hello.scala
-# Hello from Scala
 ```
 
+```text
+Hello from Scala
+```
+
+</ChainedSnippets>
+
 You can also split your code into multiple files:
 
 ```scala title=Messages.scala
@@ -82,11 +91,18 @@ object Hello {
 
 and the run them with `scala-cli`:
 
+<ChainedSnippets>
+
 ```bash
 scala-cli Hello.scala Messages.scala
-# Hello from Scala
 ```
 
+```text
+Hello from Scala
+```
+
+</ChainedSnippets>
+
 :::note
 Scala CLI compiles only the provided inputs.
 For example, if we provide only one of the files above:
@@ -124,11 +140,18 @@ object Hello {
 
 In this case, you can run all the source code files in `my-app` by supplying the directory name:
 
+<ChainedSnippets>
+
 ```bash
 scala-cli my-app
-# Hello from Scala
 ```
 
+```text
+Hello from Scala
+```
+
+</ChainedSnippets>
+
 In our experience, `scala-cli .` is the most used command; it compiles and runs all sources in the current directory.
 
 :::note
@@ -160,11 +183,20 @@ scala-cli https://gist.github.com/alexarchambault/f972d941bc4a502d70267cfbbc4d63
 `scala-cli` accepts input via Github Gist’s urls.
 It downloads the gist zip archive and runs it:
 
+<ChainedSnippets>
+
 ```bash
 scala-cli https://gist.github.com/alexarchambault/7b4ec20c4033690dd750ffd601e540ec
-# Hello
 ```
 
+```text
+Hello
+```
+
+</ChainedSnippets>
+
+More details in the [GitHub gists cookbook](../cookbooks/gists.md).
+
 ### Zip archive
 
 `scala-cli` accepts inputs via a `zip` archive path.
@@ -176,45 +208,93 @@ object Hello extends App {
 }
 ```
 
+<ChainedSnippets>
+
 ```bash ignore
 unzip -l hello.zip
-# Archive:  hello.zip
-#   Length      Date    Time    Name
-# ---------  ---------- -----   ----
-#        49  12-07-2021 00:06   Hello.scala
-# ---------                     -------
-#        49                     1 file
+```
+
+```text
+Archive:  hello.zip
+  Length      Date    Time    Name
+---------  ---------- -----   ----
+       49  12-07-2021 00:06   Hello.scala
+---------                     -------
+       49                     1 file
+```
+
+```bash ignore
 scala-cli hello.zip
-# Hello
 ```
 
+```text
+Hello
+```
+
+</ChainedSnippets>
+
 ## Piping
 
 You can also pipe code to `scala-cli` for execution:
 
 - scripts
+
+  <ChainedSnippets>
+
   ```bash
   echo 'println("Hello")' | scala-cli _.sc
-  # Hello
   ```
+  
+  ```text
+  Hello
+  ```
+
+  </ChainedSnippets>
+
 - Scala code
+
+  <ChainedSnippets>
+
   ```bash
   echo '@main def hello() = println("Hello")' | scala-cli _.scala
-  # Hello
   ```
+  
+  ```text
+  Hello
+  ```
+
+  </ChainedSnippets>
+
 - Java code
+
+  <ChainedSnippets>
+
   ```bash
   echo 'class Hello { public static void main(String args[]) { System.out.println("Hello"); } }' | scala-cli _.java
-  # Hello
   ```
+  
+  ```text
+  Hello
+  ```
+
+  </ChainedSnippets>
+
 - Markdown code (experimental)
+
+  <ChainedSnippets>
+
   ```bash
   echo '# Example Snippet
   ```scala
   println("Hello")
   ```' | scala-cli _.md
-  # Hello
   ```
+  
+  ```text
+  Hello
+  ```
+
+  </ChainedSnippets>
 
 More details in the [Piping guide](../guides/piping.md).
 
@@ -227,31 +307,56 @@ Running another Scala CLI version might be slower because it uses JVM-based Scal
 
 To run another Scala CLI version, specify it with `--cli-version` before any other argument:
 
+<ChainedSnippets>
+
 ```bash
-scala-cli --cli-version 0.1.3-51-g4d314eee-SNAPSHOT about
-# Scala CLI version 0.1.3-51-g4d314eee-SNAPSHOT
+scala-cli --cli-version 0.1.17-62-g21e1cf44-SNAPSHOT about
+```
+
+```text
+Scala CLI version: 0.1.17-62-g21e1cf44-SNAPSHOT
+Scala version (default): 3.2.1
 ```
 
+</ChainedSnippets>
+
 <!-- Expected:
-Scala CLI version 0.1.3-51-g4d314eee-SNAPSHOT
+Scala CLI version: 0.1.17-62-g21e1cf44-SNAPSHOT
+Scala version (default): 3.2.1
 -->
 
 To use the latest Scala CLI nightly build, pass `nightly` to `--cli-version` parameter:
 
+<ChainedSnippets>
+
 ```bash
 scala-cli --cli-version nightly about
-# Scala CLI version 0.1.3-8-g431cc15f-SNAPSHOT
 ```
 
+```text
+Fetching Scala CLI 0.1.17-62-g21e1cf44-SNAPSHOT
+Scala CLI version: 0.1.17-62-g21e1cf44-SNAPSHOT
+Scala version (default): 3.2.1
+```
+
+</ChainedSnippets>
+
 ## Process substitution
 
 Lastly, `scala-cli` also accepts input via shell process substitution:
 
+<ChainedSnippets>
+
 ```bash
 scala-cli <(echo 'println("Hello")')
-# Hello
 ```
 
+```text
+Hello
+```
+
+</ChainedSnippets>
+
 <!-- Expected:
 Hello
 -->

website/docs/cookbooks/gists.md

@@ -64,6 +64,7 @@ object Hello extends App {
     println(inputs.mkString(","))
 }
 ```
+
 ```scala title=input
 1
 2
@@ -72,10 +73,19 @@ object Hello extends App {
 ```
 
 and run them:
+
+<ChainedSnippets>
+
 ```bash
 scala-cli https://gist.github.com/lwronski/7ee12fa4b8b8bac3211841273df82080
-# 1,2,3,4
 ```
+
+```text
+1,2,3,4
+```
+
+</ChainedSnippets>
+
 <!-- Expected:
 1,2,3,4
 -->