diff --git a/docs/changelog.md b/docs/changelog.md
index f34b3543fa..988f57aca2 100644
--- a/docs/changelog.md
+++ b/docs/changelog.md
@@ -2,6 +2,10 @@
 
 This changelog documents user-relevant changes to the GitHub runner charm.
 
+## 2025-11-21
+
+- Updated broken links in `docs/how-to/index.md`.
+
 ## 2025-11-11
 
 - Added Grafana dashboard using Prometheus data source.
@@ -223,4 +227,4 @@ the multi-processing fighting over the file handle for the clouds.yaml file in t
 
 ## 2024-09-09
 
-- Added changelog for tracking user-relevant changes.
\ No newline at end of file
+- Added changelog for tracking user-relevant changes.
diff --git a/docs/how-to/index.md b/docs/how-to/index.md
index 1e7eb875e3..2bbf26cb9f 100644
--- a/docs/how-to/index.md
+++ b/docs/how-to/index.md
@@ -22,12 +22,12 @@ and using the Github Runner charm.
 
 <!--Links-->
 
-[Change repository or organization]: (how-to/change-path.md)
-[Change GitHub personal access token]: (how-to/change-token.md)
-[Add custom labels]: (how-to/add-custom-labels.md)
-[Debug with SSH]: (how-to/debug-with-ssh.md)
-[Integrate with COS]: (how-to/integrate-with-cos.md)
-[Spawn OpenStack runner]: (how-to/openstack-runner.md)
-[Set up reactive spawning]: (how-to/reactive.md)
-[Comply with security requirements]: (how-to/comply-security.md)
-[Contribute]: (how-to/contribute.md)
+[Change repository or organization]: change-path.md
+[Change GitHub personal access token]: change-token.md
+[Add custom labels]: add-custom-labels.md
+[Debug with SSH]: debug-with-ssh.md
+[Integrate with COS]: integrate-with-cos.md
+[Spawn OpenStack runner]: openstack-runner.md
+[Set up reactive spawning]: reactive.md
+[Comply with security requirements]: comply-security.md
+[Contribute]: contribute.md