diff --git a/sysadm/puppet/howto-deploy-puppet-change.rst b/sysadm/puppet/howto-deploy-puppet-change.rst
index d804285..2c45918 100644
--- a/sysadm/puppet/howto-deploy-puppet-change.rst
+++ b/sysadm/puppet/howto-deploy-puppet-change.rst
@@ -1,2 +1,9 @@
+.. _puppet_deploy_change:
+
 How to deploy a Puppet change
 =============================
+
+.. todo::
+   This page is a work in progress. Please refer to the `existing documentation
+   <https://forge.softwareheritage.org/source/puppet-environment/>`_ and `the
+   wiki page <https://wiki.softwareheritage.org/wiki/Puppet_setup>`_.
diff --git a/sysadm/puppet/howto-manage-third-party-modules.rst b/sysadm/puppet/howto-manage-third-party-modules.rst
index 372a46a..94ca6d1 100644
--- a/sysadm/puppet/howto-manage-third-party-modules.rst
+++ b/sysadm/puppet/howto-manage-third-party-modules.rst
@@ -1,2 +1,9 @@
+.. _puppet_third_party:
+
 How to manage Third-Party modules
 =================================
+
+.. todo::
+   This page is a work in progress. Please refer to the `existing documentation
+   <https://forge.softwareheritage.org/source/puppet-environment/>`_ and `the
+   wiki page <https://wiki.softwareheritage.org/wiki/Puppet_setup>`_.
diff --git a/sysadm/puppet/howto-test-changes-in-vagrant.rst b/sysadm/puppet/howto-test-changes-in-vagrant.rst
index 26c7e81..075d77f 100644
--- a/sysadm/puppet/howto-test-changes-in-vagrant.rst
+++ b/sysadm/puppet/howto-test-changes-in-vagrant.rst
@@ -1,2 +1,8 @@
+.. _puppet_vagrant:
+
 How to test Puppet changes in Vagrant
 =====================================
+
+.. todo::
+   This page is a work in progress. Please refer to the `existing documentation
+   <https://forge.softwareheritage.org/source/puppet-environment/>`_.
diff --git a/sysadm/puppet/reference-architecture.rst b/sysadm/puppet/reference-architecture.rst
index ae96bb2..35c0b50 100644
--- a/sysadm/puppet/reference-architecture.rst
+++ b/sysadm/puppet/reference-architecture.rst
@@ -1,2 +1,9 @@
+.. _puppet_architecture:
+
 Reference: Architecture of the Software Heritage Puppet deployment
 ==================================================================
+
+.. todo::
+   This page is a work in progress. Please refer to the `existing documentation
+   <https://forge.softwareheritage.org/source/puppet-environment/>`_ and `the
+   wiki page <https://wiki.softwareheritage.org/wiki/Puppet_setup>`_.
diff --git a/sysadm/puppet/reference-best-practices.rst b/sysadm/puppet/reference-best-practices.rst
index 6a038a7..624af43 100644
--- a/sysadm/puppet/reference-best-practices.rst
+++ b/sysadm/puppet/reference-best-practices.rst
@@ -1,2 +1,9 @@
+.. _puppet_best_practices:
+
 Reference: Puppet best practices
 ================================
+
+.. todo::
+   This page is a work in progress. Please refer to the `existing documentation
+   <https://forge.softwareheritage.org/source/puppet-environment/>`_ and `the
+   wiki page <https://wiki.softwareheritage.org/wiki/Puppet_setup>`_.
diff --git a/sysadm/puppet/tutorial-my-first-change-in-puppet.rst b/sysadm/puppet/tutorial-my-first-change-in-puppet.rst
index 11f795f..cbe8d3e 100644
--- a/sysadm/puppet/tutorial-my-first-change-in-puppet.rst
+++ b/sysadm/puppet/tutorial-my-first-change-in-puppet.rst
@@ -1,2 +1,7 @@
+.. _puppet_tutorial:
+
 Tutorial: Making my first change in Puppet
 ==========================================
+
+.. todo::
+   This page is a work in progress.