From 0a756bafad6d54f04e3a8f23c758749ed682c082 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Antoine=20Beaupr=C3=A9?= <anarcat@debian.org>
Date: Wed, 11 Dec 2024 15:42:25 -0500
Subject: [PATCH] add section on puppet upgrades

---
 howto/puppet.md | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/howto/puppet.md b/howto/puppet.md
index 083961e6..0226efb0 100644
--- a/howto/puppet.md
+++ b/howto/puppet.md
@@ -1438,6 +1438,19 @@ Then restart `puppetserver.service`.
 Starting from `trixie`, the `trocla-puppetserver` package will be available to
 replace this manual deployment of the `trocla` gem.
 
+## Upgrades
+
+Puppet upgrades can be involved, as backwards compatibility between
+releases is not always maintained. Worse, newer releases are not
+always packaged in Debian. TPA, and @lavamind in particular, worked
+really hard to package the Puppet 7 suite to Debian, which finally
+shipped in Debian 12 ("bookworm"). Lavamind also packaged Puppet 8 for
+trixie.
+
+See [issue 33588][] for the background on this.
+
+[issue 33588]: https://gitlab.torproject.org/tpo/tpa/team/-/issues/33588
+
 ## SLA
 
 No formal SLA is defined. Puppet runs on a fairly slow `cron` job so
-- 
GitLab