dotkernel · alexmerlin · Nov 24, 2025 · Nov 23, 2025 · Nov 23, 2025 · Nov 23, 2025
diff --git a/docs/book/v1/chapter-1.md b/docs/book/v1/chapter-1.md
@@ -5,7 +5,7 @@
 The first step is to add alongside your current packages the required entries for our Doctrine installation.
 We would add the following to our `composer.json` file located in our root folder:
 
-![composer](images/composer.png)
+![composer.json](images/composer.png)
 
 ```text
 "dotkernel/dot-cache": "^4.0",
@@ -84,8 +84,9 @@ This package takes all the provided configs from the `config/config.php` file an
 
 Our new `src/App/src/ConfigProvider.php` class would look like this now:
 
-![Config provider factories update](images/config-provider-1.png)
-![Doctrine config function](images/config-provider-2.png)
+![config-provider-1](images/config-provider-1.png)
+
+![config-provider-1](images/config-provider-2.png)
 
 ```php
 public function __invoke(): array
@@ -198,7 +199,7 @@ return DependencyFactory::fromEntityManager(
 Now that everything has been configured we only need to do one last thing, to create an executable for the Doctrine CLI.
 In our case we will create a `doctrine` file inside the application's `bin` directory:
 
-![bin/doctrine](images/doctrine.png)
+![doctrine](images/doctrine.png)
 
 ```php
 #!/usr/bin/env php
@@ -223,7 +224,7 @@ ConsoleRunner::run(new SingleManagerProvider($entityManager));
 (Optional) To keep things tidy, we recommend making an executable for the migrations of Doctrine as well.
 For this, we create `doctrine-migrations` file inside the application's `bin` directory:
 
-![bin/doctrine-migrations](images/doctrine-migrations.png)
+![doctrine-migrations](images/doctrine-migrations.png)
 
 ```php
 #!/usr/bin/env php

diff --git a/docs/book/v1/images/cli-config.png b/docs/book/v1/images/cli-config.png
diff --git a/docs/book/v1/images/composer.png b/docs/book/v1/images/composer.png
diff --git a/docs/book/v1/images/config-provider-1.png b/docs/book/v1/images/config-provider-1.png
diff --git a/docs/book/v1/images/config-provider-2.png b/docs/book/v1/images/config-provider-2.png
diff --git a/docs/book/v1/images/doctrine-migrations.png b/docs/book/v1/images/doctrine-migrations.png
diff --git a/docs/book/v1/images/doctrine.png b/docs/book/v1/images/doctrine.png
diff --git a/docs/book/v1/images/local.png b/docs/book/v1/images/local.png
diff --git a/docs/book/v1/introduction.md b/docs/book/v1/introduction.md
@@ -0,0 +1,11 @@
+# Introduction
+
+For the upcoming tutorial steps we assume that you already have installed the following:
+
+- A UNIX-based development environment.
+If not, we recommend [AlmaLinux](https://almalinux.org/) in a WSL2 container
+- A recent IDE, for example [PhpStorm](https://www.jetbrains.com/phpstorm/) or [VSCode](https://code.visualstudio.com/)
+- A fresh installation of [Dotkernel Light](https://github.com/dotkernel/light)
+- Default UTF-8 encoding for files and LF type line separator
+
+For any further tips related to the development environment we suggest that you check out our [development documentation](https://docs.dotkernel.org/development/v2/setup/installation/).
diff --git a/mkdocs.yml b/mkdocs.yml
@@ -7,7 +7,8 @@ extra:
     - v1
 nav:
   - Home: index.md
-  - book:
+  - Tutorial:
+      - Introduction: v1/introduction.md
       - Chapter 1: v1/chapter-1.md
 site_name: Dotkernel 101
 site_description: "Beginner tutorial for using Dotkernel"