Merge pull request #79 from dotkernel/issue-78

Issue 78: Tweaked docs

Author: alexmerlin

README.md

@@ -25,7 +25,7 @@ DXCore version: 10.0.26091.1-240325-1447.ge-release
 Windows version: 10.0.22631.3737
 ```
 
-If the output starts with `WSL version: 2.x.x.x`, you are ready to use **WSL2** and can proceed to [install AlmaLinux10](wsl/README.md).
+If the output starts with `WSL version: 2.x.x.x`, you are ready to use **WSL2** and can proceed to [install AlmaLinux 10](wsl/README.md).
 
 ## Install WSL2
 
@@ -57,4 +57,4 @@ To test, run again the following command:
 wsl -v
 ```
 
-This time the output should display `WSL version: 2.x.x.x`, which means that your system is ready for using **WSL2** and you can proceed to [install AlmaLinux10](wsl/README.md).
+This time the output should display `WSL version: 2.x.x.x`, which means that your system is ready for using **WSL2** and you can proceed to [install AlmaLinux 10](wsl/README.md).

docs/book/v1/faq.md

@@ -1,4 +1,4 @@
-# Frequently asked questions
+# AlmaLinux 9 Frequently asked questions
 
 ## How do I switch to a different version of PHP?
 

docs/book/v1/introduction.md

@@ -1,9 +1,9 @@
-# Introduction
+# AlmaLinux 9 Introduction
 
 `dotkernel/development` is a tool that helps you prepare your development environment with the following components:
 
 * **WSL2**: Windows Subsystem for Linux
-* **AlmaLinux9**: free and open source Linux distribution
+* **AlmaLinux 9**: free and open source Linux distribution
 * **PHP**: general-purpose scripting language geared towards web development
 * **Apache**: free and open-source cross-platform web server software
 * **MariaDB**: community-developed, commercially supported fork of the MySQL relational database management system

docs/book/v1/setup/installation.md

@@ -1,4 +1,4 @@
-# Install AlmaLinux9
+# AlmaLinux 9 Installation
 
 Before proceeding with the installation, we need to make sure that no other WSL2 distribution (aka: _distro_) is running.
 This is important because this installation will fail if required ports are already in use by another distro.
@@ -19,21 +19,21 @@ If there is no other distro installed, you will see the below output (an empty l
   NAME            STATE           VERSION
 ```
 
-In this case, you can jump to the [installation](#install-almalinux9-1) section.
+In this case, you can jump to the [installation](#install-almalinux-9) section.
 
 If you have other distros installed, the output could look similar to the below:
 
 ```text
   NAME            STATE           VERSION
-* AlmaLinux-9     Stopped         2
+  AlmaLinux-9     Stopped         2
 * AlmaLinux-10    Running         2
 ```
 
 Make sure that the **STATE** column reads **Stopped** for all distros.
-If any of them reads **Running**, you must stop if first by executing `wsl -t <distro-name>`, for example: `wsl -t AlmaLinux-10`.
-Once you have stopped all distros, you can continue to the [installation](#install-almalinux9-1) section.
+If any of them reads **Running**, you must stop if first by executing `wsl -t <distro-name>` after replacing `<distro-name>` with the name of the distro you want to stop.
+Once you have stopped all distros, you can continue to the [installation](#install-almalinux-9) section.
 
-## Install AlmaLinux9
+## Install AlmaLinux 9
 
 List the available Linux distros by executing:
 
@@ -82,7 +82,7 @@ A distribution with the supplied name already exists. Use --name to choose a dif
 Error code: Wsl/InstallDistro/Service/RegisterDistro/ERROR_ALREADY_EXISTS
 ```
 
-Install the AlmaLinux9 distro by executing the below command:
+Install the **AlmaLinux 9** distro by executing the below command:
 
 ```shell
 wsl --install -d AlmaLinux-9
@@ -101,7 +101,7 @@ Enter new UNIX username:
 ```
 
 As per the last line, the installation process now prompts you to enter a username.
-This is the username you will use inside AlmaLinux9, and it can be any alphanumeric string (for example `dotkernel`):
+This is the username you will use inside **AlmaLinux 9**, and it can be any alphanumeric string (for example `dotkernel`):
 
 Next, you are prompted to change the password associated with your chosen username (you will not see what you are typing, that's a security measure in Linux regarding passwords):
 
@@ -123,5 +123,5 @@ Finally, you should see the following message:
 
 ```text
 passwd: all authentication tokens updated successfully.
-[<your-almalinux9-username>@<your-device-name> <your-windows-username>]$
+[<your-alma-linux-9-username>@<your-device-name> <your-windows-username>]$
 ```

docs/book/v1/setup/setup-packages.md

@@ -1,4 +1,4 @@
-# Setup AlmaLinux9
+# AlmaLinux 9 Setup
 
 Install system packages:
 
@@ -19,7 +19,7 @@ Administrator. It usually boils down to these three things:
 [sudo] password for dotkernel:
 ```
 
-Input your AlmaLinux9 password and hit `Enter`.
+Input your **AlmaLinux 9** password and hit `Enter`.
 
 Update/Upgrade system packages:
 
@@ -33,16 +33,16 @@ Now, install the latest version of **Ansible**:
 sudo dnf install ansible -y
 ```
 
-Move inside your home directory (it is `/home/` followed by your AlmaLinux9 username, for example: `/home/dotkernel`):
+Move inside your home directory (it is `/home/` followed by your **AlmaLinux 9** username, for example: `/home/dotkernel`):
 
 ```shell
 cd ~
 ```
 
-Clone the `almalinux9` branch of the `dotkernel/development` repository:
+Clone the `alma-linux-9` branch of the `dotkernel/development` repository:
 
 ```shell
-git clone --branch almalinux9 --single-branch https://github.com/dotkernel/development.git
+git clone --branch alma-linux-9 --single-branch https://github.com/dotkernel/development.git
 ```
 
 Move inside the directory `development/wsl`:
@@ -66,34 +66,34 @@ Install components by running the below Ansible command:
 ansible-playbook -i hosts install.yml --ask-become-pass
 ```
 
-The installation process will ask for your AlmaLinux9 password, then iterate over each task in the playbook and output a short summary with the results.
+The installation process will ask for your **AlmaLinux 9** password, then iterate over each task in the playbook and output a short summary with the results.
 
 Once finished, check if everything works by opening in your browser:
 
 * [http://localhost/](http://localhost/): Apache's default home page
 * [http://localhost/info.php](http://localhost/info.php): PHP info page
 * [http://localhost/phpmyadmin/](http://localhost/phpmyadmin/): PhpMyAdmin (login with `root` + the root password you configured in `config.yml` under `mariadb` -> `root_password`)
 
-The installation is complete, your AlmaLinux9 development environment is ready to use.
+The installation is complete, your **AlmaLinux 9** development environment is ready to use.
 
-> Restart your `Windows Terminal` to find a new option in the tab selector, called **AlmaLinux-9** - clicking it will open a new tab connected to **AlmaLinux9**.
+> Restart your `Windows Terminal` to find a new option in the tab selector, called **AlmaLinux-9** - clicking it will open a new tab connected to **AlmaLinux 9**.
 
-## Running AlmaLinux9
+## Running AlmaLinux 9
 
 Open `Windows Terminal`.
 
-Start AlmaLinux9 by executing:
+Start **AlmaLinux 9** by executing:
 
 ```shell
-wsl -d AlmaLinux9
+wsl -d AlmaLinux-9
 ```
 
 OR
 
 Locate the app selector dropdown in `Windows Terminal`'s title bar and click `AlmaLinux-9`.
-This will open a new tab connected to AlmaLinux9.
+This will open a new tab connected to **AlmaLinux 9**.
 
 ### Note
 
-> To run your applications using WSL2, you always need to be connected to your AlmaLinux9 distribution.
+> To run your applications using WSL2, you always need to be connected to your **AlmaLinux 9** distribution.
 > For this, all you need to do is to keep open an instance of Windows Terminal that is connected to it.

docs/book/v1/setup/system-requirements.md

@@ -1,4 +1,4 @@
-# System requirements
+# AlmaLinux 9 System requirements
 
 If you're not already using it, we recommend you to install [Windows Terminal](https://apps.microsoft.com/detail/9n0dx20hk701?hl=en-US&gl=US).
 It is a modern tool that incorporates the power of multiple already known command-line applications like `Windows PowerShell`, `Linux shell`, and more...
@@ -23,7 +23,7 @@ DXCore version: 10.0.26091.1-240325-1447.ge-release
 Windows version: 10.0.22631.3737
 ```
 
-If the output starts with `WSL version: 2.x.x.x`, you are ready to use **WSL2** and can proceed to [install AlmaLinux9](installation.md).
+If the output starts with `WSL version: 2.x.x.x`, you are ready to use **WSL2** and can proceed to [install AlmaLinux 9](installation.md).
 
 ## Install WSL2
 
@@ -55,4 +55,4 @@ To test, run again the following command:
 wsl -v
 ```
 
-This time the output should display `WSL version: 2.x.x.x`, which means that your system is ready for using **WSL2** and you can proceed to [install AlmaLinux9](installation.md).
+This time the output should display `WSL version: 2.x.x.x`, which means that your system is ready for using **WSL2** and you can proceed to [install AlmaLinux 9](installation.md).

docs/book/v1/virtualhosts/create-virtualhost.md

@@ -1,4 +1,4 @@
-# Create virtualhosts
+# AlmaLinux 9 Create virtualhosts
 
 > By using the `*.localhost` pattern for any new virtualhost, you do not need to modify the `hosts` file in Windows, because these are routed by default.
 
@@ -20,7 +20,7 @@ Create the specified virtualhosts:
 ansible-playbook -i hosts create-virtualhost.yml --ask-become-pass
 ```
 
-This process will ask for your AlmaLinux10 password, iterate over the list of configured `virtualhosts` and output a short summary with the results.
+This process will ask for your **AlmaLinux 9** password, iterate over the list of configured `virtualhosts` and output a short summary with the results.
 Your virtualhost should be accessible and ready to use.
 
 You will install your project under the `html` directory of your project, for example `/var/www/example.localhost/html`.
@@ -31,7 +31,7 @@ You will install your project under the `html` directory of your project, for ex
 
 ## Good to know
 
-* To run your installed projects, you need to start AlmaLinux9 first.
+* To run your installed projects, you need to start **AlmaLinux 9** first.
 * If you work with virtualhosts, your projects are created under `/var/www/`.
 * You can still run PHP scripts under the default Apache project directory, located at `/var/www/html/`.
 * If you encounter write permission issues, see [this guide](https://docs.dotkernel.org/development/v1/faq/#how-do-i-fix-common-permission-issues).

docs/book/v1/virtualhosts/overview.md

@@ -1,4 +1,4 @@
-# Overview
+# AlmaLinux 9 Overview
 
 Virtualhosts allow developers to host multiple applications on their local system.
 
@@ -11,7 +11,7 @@ Using this tool, you configure a virtualhost for each of your applications, and
 
 In the above example, the URLs are built like this:
 
-* the subdomain is the identifier of your application (`api`/`frontend`)
+* the subdomain is the identifier of your application (`api` / `frontend`)
 * the domain is the identifier of your project (`dotkernel`)
 * the TLD sends the requests to localhost where Apache will route them to their real location
 

docs/book/v2/faq.md

@@ -1,4 +1,4 @@
-# Frequently asked questions
+# AlmaLinux 10 Frequently asked questions
 
 ## How do I switch to a different version of PHP?
 
@@ -27,9 +27,10 @@ php -v
 Depending on the selected PHP version, the output should look similar to the below:
 
 ```text
-PHP 8.3.8 (cli) (built: Jun  4 2024 14:53:17) (NTS gcc x86_64)
+PHP 8.4.8 (cli) (built: Jun  3 2025 16:29:26) (NTS gcc x86_64)
 Copyright (c) The PHP Group
-Zend Engine v4.3.8, Copyright (c) Zend Technologies
+Built by Remi's RPM repository <https://rpms.remirepo.net/> #StandWithUkraine
+Zend Engine v4.4.8, Copyright (c) Zend Technologies
 ```
 
 ## How do I switch to a different version of Node.js?

docs/book/v2/introduction.md

@@ -1,9 +1,9 @@
-# Introduction
+# AlmaLinux 10 Introduction
 
 `dotkernel/development` is a tool that helps you prepare your development environment with the following components:
 
 * **WSL2**: Windows Subsystem for Linux
-* **AlmaLinux10**: free and open source Linux distribution
+* **AlmaLinux 10**: free and open source Linux distribution
 * **PHP**: general-purpose scripting language geared towards web development
 * **Apache**: free and open-source cross-platform web server software
 * **MariaDB**: community-developed, commercially supported fork of the MySQL relational database management system