diff --git a/sysadm/puppet/howto-deploy-puppet-change.rst b/sysadm/puppet/howto-deploy-puppet-change.rst
new file mode 100644
index 0000000..67a2806
--- /dev/null
+++ b/sysadm/puppet/howto-deploy-puppet-change.rst
@@ -0,0 +1,2 @@
+How to deploy a puppet change
+=============================
diff --git a/sysadm/puppet/howto-manage-third-party-modules.rst b/sysadm/puppet/howto-manage-third-party-modules.rst
new file mode 100644
index 0000000..372a46a
--- /dev/null
+++ b/sysadm/puppet/howto-manage-third-party-modules.rst
@@ -0,0 +1,2 @@
+How to manage Third-Party modules
+=================================
diff --git a/sysadm/puppet/howto-test-changes-in-vagrant.rst b/sysadm/puppet/howto-test-changes-in-vagrant.rst
new file mode 100644
index 0000000..26c7e81
--- /dev/null
+++ b/sysadm/puppet/howto-test-changes-in-vagrant.rst
@@ -0,0 +1,2 @@
+How to test Puppet changes in Vagrant
+=====================================
diff --git a/sysadm/puppet/index.rst b/sysadm/puppet/index.rst
new file mode 100644
index 0000000..a8c6980
--- /dev/null
+++ b/sysadm/puppet/index.rst
@@ -0,0 +1,12 @@
+Puppet
+======
+
+.. toctree::
+   :titlesonly:
+
+   tutorial-my-first-change-in-puppet
+   howto-manage-third-party-modules
+   howto-test-changes-in-vagrant
+   howto-deploy-puppet-change
+   reference-architecture
+   reference-best-practices
diff --git a/sysadm/puppet/reference-architecture.rst b/sysadm/puppet/reference-architecture.rst
new file mode 100644
index 0000000..8f873a6
--- /dev/null
+++ b/sysadm/puppet/reference-architecture.rst
@@ -0,0 +1,2 @@
+Reference: Architecture of the Software Heritage puppet deployment
+==================================================================
diff --git a/sysadm/puppet/reference-best-practices.rst b/sysadm/puppet/reference-best-practices.rst
new file mode 100644
index 0000000..6a038a7
--- /dev/null
+++ b/sysadm/puppet/reference-best-practices.rst
@@ -0,0 +1,2 @@
+Reference: Puppet best practices
+================================
diff --git a/sysadm/puppet/tutorial-my-first-change-in-puppet.rst b/sysadm/puppet/tutorial-my-first-change-in-puppet.rst
new file mode 100644
index 0000000..11f795f
--- /dev/null
+++ b/sysadm/puppet/tutorial-my-first-change-in-puppet.rst
@@ -0,0 +1,2 @@
+Tutorial: Making my first change in Puppet
+==========================================