diff --git a/.changelog/bc86f3ff5947408287b796d73e1b1ea6.md b/.changelog/bc86f3ff5947408287b796d73e1b1ea6.md
new file mode 100644
index 0000000..9db8729
--- /dev/null
+++ b/.changelog/bc86f3ff5947408287b796d73e1b1ea6.md
@@ -0,0 +1,4 @@
+---
+type: none
+---
+Fix doc linking warns
\ No newline at end of file
diff --git a/docs/examples/basic/README.md b/docs/examples/basic/README.md
index 74e848d..71f5fe3 100644
--- a/docs/examples/basic/README.md
+++ b/docs/examples/basic/README.md
@@ -1,3 +1,5 @@
+(basic-setup)=
+
 # Basic Setup
 
 This is the starting point octoDNS config, it's pretty similar to what you
diff --git a/docs/examples/custom/index.rst b/docs/examples/custom/index.rst
index 2a44efd..7a017d3 100644
--- a/docs/examples/custom/index.rst
+++ b/docs/examples/custom/index.rst
@@ -37,7 +37,7 @@ to get a copy of the example files::
   $ source env/bin/activate
   (env) $ pip install -r requirements.txt
 
-Finally check out :ref:`Running PowerDNS` to get a local instance of PowerDNS
+Finally check out :ref:`running-powerdns` to get a local instance of PowerDNS
 up and going before continuing.
 
 Running octoDNS sync
@@ -111,7 +111,7 @@ Everything here matches the output and meaning of the first run in
 :ref:`basic-setup`, with the important difference that both the statically
 configured and dynamically generated records are listed as planned changes.
 From here a ``--doit`` run can be executed to create the records in the
-PowerDNS server, which can then be queried::
+PowerDNS server, which can then be queried.
 
 Viewing the results
 -------------------