Update the documentation

Author: braboj

.scripts/gen_markdown_examples.py renamed to .scripts/gen_markdown_pages.py

@@ -18,6 +18,29 @@
 * [`#####`] - Move the image assets to a dedicated folder
 ```
 
-### Pull Requests
+[//]: # (## Pull Requests)
 
-- https://blog.montrealanalytics.com/4-tips-for-effective-pull-request-naming-f60793998f04]
+[//]: # ()
+[//]: # (- https://blog.montrealanalytics.com/4-tips-for-effective-pull-request-naming-f60793998f04])
+
+
+## Building the MkDocs Site
+
+Follow these steps to generate the static documentation using MkDocs.
+
+1. Install the required Python packages:
+   ```bash
+   pip install -r requirements.txt
+   ```
+2. Build the site:
+   ```bash
+   mkdocs build
+   ```
+   The generated files will appear in the `site/` directory.
+3. To preview the documentation locally, run:
+   ```bash
+   mkdocs serve
+   ```
+
+Navigation is created automatically by the `mkdocs-awesome-pages-plugin` based on
+files inside the `docs/` folder.