📝 docs: add some emojis and fix some rendering issues

Author: bassemkaroui

docs/features/docker.md

@@ -12,7 +12,7 @@ When `dockerfile: true` (the default), the template generates Docker configurati
 
 ## Commands
 
-/// tab | make
+/// tab | :simple-make: make
 
 ```bash
 # Build Docker images
@@ -27,7 +27,7 @@ make docker-stop
 
 ///
 
-/// tab | mise
+/// tab | :material-wrench: mise
 
 ```bash
 # Build Docker images

docs/features/documentation.md

@@ -11,7 +11,7 @@ Generated projects include a fully configured [MkDocs](https://github.com/mkdocs
 
 ## Local Development
 
-/// tab | make
+/// tab | :simple-make: make
 
 ```bash
 # Serve docs with live reload (localhost:8080)
@@ -23,7 +23,7 @@ make docs-check
 
 ///
 
-/// tab | mise
+/// tab | :material-wrench: mise
 
 ```bash
 # Serve docs with live reload (localhost:8080)
@@ -37,7 +37,7 @@ mise run docs:check
 
 ## Deployment
 
-/// tab | make
+/// tab | :simple-make: make
 
 ```bash
 # Deploy to GitHub Pages
@@ -46,7 +46,7 @@ make docs-deploy
 
 ///
 
-/// tab | mise
+/// tab | :material-wrench: mise
 
 ```bash
 # Deploy to GitHub Pages

docs/features/optional.md

@@ -10,7 +10,7 @@ Scaffolds a [Typer](https://typer.tiangolo.com/) CLI application with:
 - CLI module with a sample command
 - Customizable CLI name via the `cli_name` variable
 
-/// tab | make
+/// tab | :simple-make: make
 
 ```bash
 # Install CLI globally after generation
@@ -19,7 +19,7 @@ make setup-cli
 
 ///
 
-/// tab | mise
+/// tab | :material-wrench: mise
 
 ```bash
 # Install CLI globally after generation

docs/features/quality-tools.md

@@ -6,7 +6,7 @@ The template sets up a comprehensive code quality pipeline that runs automatical
 
 [Ruff](https://github.com/astral-sh/ruff) handles both **formatting** and **linting** in a single, fast tool.
 
-/// tab | make
+/// tab | :simple-make: make
 
 ```bash
 # Auto-format code
@@ -18,7 +18,7 @@ make check-quality
 
 ///
 
-/// tab | mise
+/// tab | :material-wrench: mise
 
 ```bash
 # Auto-format code
@@ -36,15 +36,15 @@ Ruff is configured in `pyproject.toml` with sensible defaults. It replaces Black
 
 [Mypy](https://github.com/python/mypy) performs static type checking.
 
-/// tab | make
+/// tab | :simple-make: make
 
 ```bash
 make check-types
 ```
 
 ///
 
-/// tab | mise
+/// tab | :material-wrench: mise
 
 ```bash
 mise run check:types
@@ -74,7 +74,7 @@ pre-commit install
 
 ## Running All Checks
 
-/// tab | make
+/// tab | :simple-make: make
 
 ```bash
 # Run everything: lint, types, docs build
@@ -83,7 +83,7 @@ make check-all
 
 ///
 
-/// tab | mise
+/// tab | :material-wrench: mise
 
 ```bash
 # Run everything: lint, types, docs build

docs/features/task-runner.md

@@ -4,17 +4,26 @@ Project tasks are defined in a [`mise.toml`](https://mise.jdx.dev/) file. A `Mak
 
 Run any task with:
 
+/// tab | :simple-make: make
+
 ```bash
 make <task>
-# or directly:
+```
+
+///
+
+/// tab | :material-wrench: mise
+
+```bash
 mise run <task>
 ```
 
-> [!TIP]
-> Prefer `mise run` over `make` when running tasks directly:
->
-> - **Auto-completion**: Run `make mise-setup-completions` to install shell completions for mise, giving you tab-completion for all tasks.
-> - **Flags & arguments**: mise tasks can accept flags and positional arguments (e.g. `mise run docker-build --dev`, `mise run test -- -k test_foo`), which is not possible through `make`.
+///
+
+!!! tip "Prefer `mise run` over `make` when running tasks directly"
+
+    - **Auto-completion**: Run `make mise-setup-completions` to install shell completions for mise, giving you tab-completion for all tasks.
+    - **Flags & arguments**: mise tasks can accept flags and positional arguments (e.g. `mise run docker-build --dev`, `mise run test -- -k test_foo`), which is not possible through `make`.
 
 ## Available Tasks
 

docs/features/testing.md

@@ -6,15 +6,15 @@ The template configures a full testing setup with pytest, coverage reporting, an
 
 [pytest](https://github.com/pytest-dev/pytest) is the default test runner. Tests live in the `tests/` directory.
 
-/// tab | make
+/// tab | :simple-make: make
 
 ```bash
 make test
 ```
 
 ///
 
-/// tab | mise
+/// tab | :material-wrench: mise
 
 ```bash
 mise run test
@@ -26,15 +26,15 @@ mise run test
 
 [Coverage.py](https://github.com/nedbat/coveragepy) generates test coverage reports in text, HTML, and XML formats.
 
-/// tab | make
+/// tab | :simple-make: make
 
 ```bash
 make coverage
 ```
 
 ///
 
-/// tab | mise
+/// tab | :material-wrench: mise
 
 ```bash
 mise run coverage
@@ -48,15 +48,15 @@ The coverage threshold is configurable via the `coverage_threshold` template var
 
 [Tox](https://github.com/tox-dev/tox) with [tox-uv](https://github.com/tox-dev/tox-uv) runs your test suite across multiple Python versions.
 
-/// tab | make
+/// tab | :simple-make: make
 
 ```bash
 make tox
 ```
 
 ///
 
-/// tab | mise
+/// tab | :material-wrench: mise
 
 ```bash
 mise run tox
@@ -70,7 +70,7 @@ Tox is included by default but can be disabled by setting `tox: false` during pr
 
 For parallel test execution, enable the `pytest_xdist` option during generation. This adds [pytest-xdist](https://github.com/pytest-dev/pytest-xdist) to your test dependencies.
 
-/// tab | make
+/// tab | :simple-make: make
 
 ```bash
 # Tests automatically run in parallel when pytest-xdist is installed
@@ -79,7 +79,7 @@ make test
 
 ///
 
-/// tab | mise
+/// tab | :material-wrench: mise
 
 ```bash
 # Tests automatically run in parallel when pytest-xdist is installed

docs/getting-started/prerequisites.md

@@ -15,14 +15,14 @@ Before using this template, make sure you have the following tools installed:
 
 ## Quick Install
 
-/// tab | macOS (Homebrew)
+/// tab | :fontawesome-brands-apple: macOS (Homebrew)
 ```bash
 brew install python uv mise pre-commit
 uv tool install copier --with copier-templates-extensions
 ```
 ///
 
-/// tab | Linux
+/// tab | :fontawesome-brands-linux: Linux
 ```bash
 # uv
 curl -LsSf https://astral.sh/uv/install.sh | sh
@@ -38,7 +38,7 @@ uv tool install copier --with copier-templates-extensions
 ```
 ///
 
-/// tab | Windows
+/// tab | :fontawesome-brands-windows: Windows
 ```powershell
 # uv
 powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

docs/getting-started/quickstart.md

@@ -2,7 +2,7 @@
 
 ## Scaffold a New Project
 
-/// tab | Using uvx (no install needed)
+/// tab | :simple-uv: Using uvx (no install needed)
 
 ```bash
 uvx --with copier-templates-extensions copier copy \
@@ -11,7 +11,7 @@ uvx --with copier-templates-extensions copier copy \
 
 ///
 
-/// tab | Using installed Copier
+/// tab | :material-package: Using installed Copier
 
 ```bash
 # Install Copier globally (one-time)
@@ -24,13 +24,15 @@ copier copy --trust gh:bassemkaroui/python-template-uv project_name
 ///
 
 !!! note "Why `--trust`?"
-The template runs post-generation tasks (`git init`, `make setup-dev`, etc.) defined in `copier.yaml`, which requires the `--trust` flag.
+    The template runs post-generation tasks (`git init`, `make setup-dev`, etc.) defined in `copier.yaml`, which requires the `--trust` flag.
 
-!!! tip "Additional flags" - Add `--prereleases` to include pre-release template versions - Add `--vcs-ref=HEAD` to use the latest commit instead of the latest release
+!!! tip "Additional flags"
+    - Add `--prereleases` to include pre-release template versions
+    - Add `--vcs-ref=HEAD` to use the latest commit instead of the latest release
 
 ## Set Up Your Project
 
-/// tab | make
+/// tab | :simple-make: make
 
 ```bash
 # Enter your project
@@ -46,7 +48,7 @@ make setup-cli
 
 ///
 
-/// tab | mise
+/// tab | :material-wrench: mise
 
 ```bash
 # Enter your project
@@ -64,7 +66,7 @@ mise run setup:cli
 
 ## Verify Everything Works
 
-/// tab | make
+/// tab | :simple-make: make
 
 ```bash
 # Run all checks: lint, types, docs build
@@ -73,7 +75,7 @@ make check-all
 
 ///
 
-/// tab | mise
+/// tab | :material-wrench: mise
 
 ```bash
 # Run all checks: lint, types, docs build

mise.toml

@@ -10,7 +10,7 @@ run = "uv run mkdocs build --strict ${usage_verbose:+--verbose}"
 description = "Serve the documentation locally (localhost:8080)"
 quiet = true
 usage = 'flag "--port <port>" default="8080"'
-run = "uv run mkdocs serve --dev-addr 127.0.0.1:${usage_port?}"
+run = "uv run mkdocs serve --dev-addr 127.0.0.1:${usage_port?} --livereload"
 
 [tasks."docs:deploy"]
 description = "Deploy the documentation to GitHub Pages"

template/mise.toml.jinja

@@ -230,7 +230,7 @@ run = "uv run mkdocs build --strict ${usage_verbose:+--verbose}"
 description = "Serve the documentation locally (localhost:8080)"
 quiet = true
 usage = 'flag "--port <port>" default="8080"'
-run = "uv run mkdocs serve --dev-addr 127.0.0.1:${usage_port?}"
+run = "uv run mkdocs serve --dev-addr 127.0.0.1:${usage_port?} --livereload"
 {% if repository_provider == 'github' %}
 [tasks."docs:deploy"]
 description = "Deploy the documentation to GitHub Pages"