diff --git a/docs/changelog.d/zk-docs-troubleshooting.doc.md b/docs/changelog.d/zk-docs-troubleshooting.doc.md
new file mode 100644
index 0000000..7f528d0
--- /dev/null
+++ b/docs/changelog.d/zk-docs-troubleshooting.doc.md
@@ -0,0 +1 @@
+Add troubleshooting how-to to zk-docs output
diff --git a/mise-tasks/zk-docs b/mise-tasks/zk-docs
index 6eca11b..d12b85e 100755
--- a/mise-tasks/zk-docs
+++ b/mise-tasks/zk-docs
@@ -10,6 +10,7 @@ FILES=(
     "$DOCS_DIR/tutorials/ai-assistance-guide.md"
     "$DOCS_DIR/reference/index.md"
     "$DOCS_DIR/how-to/index.md"
+    "$DOCS_DIR/how-to/troubleshooting.md"
     "$DOCS_DIR/explanation/architecture.md"
     "$DOCS_DIR/tutorials/index.md"
 )