From 8d5e106317d889447f9f6666722723103ea165c5 Mon Sep 17 00:00:00 2001
From: Oliver Davies <oliver@oliverdavies.uk>
Date: Thu, 14 Aug 2025 09:35:01 +0100
Subject: [PATCH] Fix headings

---
 book/index.adoc | 80 ++++++++++++++++++++++++-------------------------
 1 file changed, 40 insertions(+), 40 deletions(-)

diff --git a/book/index.adoc b/book/index.adoc
index 5dc8d82..89630f5 100644
--- a/book/index.adoc
+++ b/book/index.adoc
@@ -25,8 +25,8 @@
 
 include::introduction/index.adoc[]
 
-[installing_php]
-== Other ways to install PHP
+[[installing_php]]
+= Other ways to install PHP
 
 ////
 apt, yum, pacman, etc. System package managers.
@@ -34,11 +34,11 @@ Homebrew on macOS and Linux.
 Docker, podman, DDEV (containers).
 Valet/Herd?
 Symfony CLI.
-Is there an "official" way on php.net?
+Is there an "official" way on php.net? https://www.php.net/manual/en/install.php
 ////
 
-[different_versions]
-== Different versions of PHP for different projects
+[[different_versions]]
+= Different versions of PHP for different projects
 
 ////
 Virtual machines.
@@ -53,23 +53,23 @@ Why do you need a full operating system?
 Why use something specific to a particular framework?
 ////
 
-[what_nix]
-== What is Nix?
+[[what_nix]]
+= What is Nix?
 
-[nix_language]
-=== The language
+[[nix_language]]
+== The language
 
-[nix_package_manager]
-=== The package manager
+[[nix_package_manager]]
+== The package manager
 
-[nix_build_tool]
-=== The build tool
+[[nix_build_tool]]
+== The build tool
 
-[nixos]
-=== The operating system (NixOS)
+[[nixos]]
+== The operating system (NixOS)
 
-[nix_benefits]
-== What are the benefits of using Nix?
+[[nix_benefits]]
+= What are the benefits of using Nix?
 
 ////
 Lightweight.
@@ -82,15 +82,15 @@ Lots of available packages and operating system options.
 Ecosystem of tools - e.g. Home Manager.
 ////
 
-=== Reproducible software, not just repeatable
+== Reproducible software, not just repeatable
 
-=== Imperative vs. declarative
+== Imperative vs. declarative
 
-[dev_shells]
-== What are dev shells?
+[[dev_shells]]
+= What are dev shells?
 
-[direnv]
-== dev shells and direnv
+[[direnv]]
+= dev shells and direnv
 
 Using a local flake:
 
@@ -99,7 +99,7 @@ Using a local flake:
 use flake .
 ----
 
-=== Remote dev shells
+== Remote dev shells
 
 Using a remote flake:
 
@@ -117,41 +117,41 @@ use flake "git+https://code.oliverdavies.uk/opdavies/dev-shells#php84"
 This will install PHP 8.4, Composer and Phpactor without needing to create a bespoke `flake.nix`.
 
 [NOTE]
-====
+===
 If you're referencing a GitHub repository, you can use the shorter `github:username/repo` format instead of the full repository URL.
-====
+===
 
-[what_flakes]
-== What are Flakes?
+[[what_flakes]]
+= What are Flakes?
 
-[flake_templates]
-=== Flake templates
+[[flake_templates]]
+== Flake templates
 
 ////
 flake-utils
 flake-parts
 ////
 
-[configuring_php]
-== Configuring PHP with Nix
+[[configuring_php]]
+= Configuring PHP with Nix
 
-[managing_services]
-== Managing services without NixOS
+[[managing_services]]
+= Managing services without NixOS
 
-[building_derivations]
-== Building derivations of PHP applications
+[[building_derivations]]
+= Building derivations of PHP applications
 
-[nix_composer]
-== Nix vs. Composer
+[[nix_composer]]
+= Nix vs. Composer
 
 ////
 composer2nix
 ////
 
-== Other usages for Nix
+= Other usages for Nix
 
 ////
 Homelab/Server
 ////
 
-== Organising Nix configurations
+= Organising Nix configurations