feat: reorganize documentation and rewrite first chapters

Author: innocenzi

src/Web/Documentation/content/main/0-getting-started/00-introduction.md

@@ -5,9 +5,9 @@ description: "Tempest is a PHP framework designed to get out of your way. Its co
 
 Tempest makes writing PHP applications pleasant thanks to carefully crafted quality-of-life features that feel like a natural extension of vanilla PHP.
 
-It embraces modern PHP syntax in its implementation of routing, ORM, console commands, messaging, logging, it takes inspiration from the best front-end frameworks for its templating engine syntax, and provides unique capabilities amongst other framework, such as [discovery](../3-internals/02-discovery), to improve developer experience.
+It embraces modern PHP syntax in its implementation of routing, ORM, console commands, messaging, logging, it takes inspiration from the best front-end frameworks for its templating engine syntax, and provides unique capabilities, such as [discovery](../3-internals/02-discovery), to improve developer experience.
 
-You may also be interested in reading how it has an [unfair advantage](/blog/unfair-advantage) over other frameworks. But code says more than words, so here are a few examples of code written on top of Tempest:
+You may be interested in reading how it has an [unfair advantage](/blog/unfair-advantage) over other frameworks—but code says more than words, so here are a few examples of code written on top of Tempest:
 
 ```php
 use Tempest\Router\Get;
@@ -87,6 +87,8 @@ This is a [console command](../2-console/02-building-console-commands). Console
 
 This example also shows how to [register events globally](../1-framework/07-events) using the `#[EventHandler]`.
 
+---
+
 :::info Ready to give it a try?
 Keep on reading and consider [**giving Tempest a star️ on GitHub**](https://github.com/tempestphp/tempest-framework). If you want to be part of the community, you can [**join our Discord server**](https://discord.gg/pPhpTGUMPQ), and if you feel like contributing, you can check out our [contributing guide](/docs/internals/contributing)!
 :::

src/Web/Documentation/content/main/0-getting-started/01-getting-started.md

@@ -16,23 +16,23 @@ Once the prerequisites are installed, you can chose your installation method. Te
 To get started with a new Tempest project, you may use {`tempest/app`} as the starting point. The `composer create-project` command will scaffold it for you:
 
 ```sh
-composer create-project tempest/app my-app --stability alpha
-cd my-app
+{:hl-keyword:composer:} create-project tempest/app {:hl-type:my-app:} --stability alpha
+{:hl-keyword:cd:} {:hl-type:my-app:}
 ```
 
 If you have a dedicated development environment, you may then access your application by opening `https://my-app.test` in your browser. Otherwise, you may use PHP's built-in server:
 
 ```sh
-php tempest serve
-# PHP 8.3.3 Development Server (http://localhost:8000) started
+{:hl-keyword:php:} tempest serve
+{:hl-comment:PHP 8.3.3 Development Server (http://localhost:8000) started:}
 ```
 
 ### Scaffolding front-end assets
 
 Optionally, you may install a basic front-end scaffolding that includes [Vite](https://vite.dev/) and [Tailwind CSS](https://tailwindcss.com/). To do so, run the Vite installer and follow through the wizard:
 
 ```sh
-php tempest install vite --tailwind
+{:hl-keyword:php:} tempest install vite --tailwind
 ```
 
 <!-- TODO: docs -->
@@ -41,21 +41,21 @@ The assets created by this wizard, `main.entrypoint.ts` and `main.entrypoint.css
 You may then run the front-end development server, which will serve your assets on-the-fly:
 
 ```bash
-npm run dev
+{:hl-keyword:npm:} run dev
 ```
 
 ## Tempest as a package
 
 If you already have a project, you can opt to install {`tempest/framework`} as a standalone package. You could do this in any project; it could already contain code, or it could be an empty project.
 
 ```sh
-composer require tempest/framework:1.0-alpha.5
+{:hl-keyword:composer:} require tempest/framework:1.0-alpha.5
 ```
 
 Installing Tempest this way will give you access to the Tempest console, `./vendor/bin/tempest`. Optionally, you can choose to install Tempest's entry points in your project. To do so, you may run the framework installer:
 
 ```txt
-./vendor/bin/tempest install framework
+{:hl-keyword:./vendor/bin/tempest:} install framework
 ```
 
 This installer will prompt you to install the following files into your project:
@@ -84,10 +84,10 @@ The following projects structures work the same way in Tempest, without requirin
 ```txt
 app
 ├── Console
-│   └── RssSyncCommand.php
+│   └── RssSyncCommand.php
 ├── Controllers
-│   ├── BlogPostController.php
-│   └── HomeController.php
+│   ├── BlogPostController.php
+│   └── HomeController.php
 └── Views
     ├── blog.view.php
     └── home.view.php
@@ -96,9 +96,9 @@ app
 ```txt
 src
 ├── Blog
-│   ├── BlogPostController.php
-│   ├── RssSyncCommand.php
-│   └── blog.view.php
+│   ├── BlogPostController.php
+│   ├── RssSyncCommand.php
+│   └── blog.view.php
 └── Home
     ├── HomeController.php
     └── home.view.php
@@ -174,12 +174,12 @@ By default, the discovery cache is disabled in local development. Depending on y
 This caching strategy will only cache discovery for vendor files. For this reason, it is recommended to run `discovery:generate` after every composer update:
 
 ```json
-{:hl-comment:// …:}
-
-"scripts": {
+{
+  "scripts": {
     "post-package-update": [
-        "php tempest discovery:generate"
+      "php tempest discovery:generate"
     ]
+  }
 }
 ```