howto/upgrades.md

 [[_TOC_]]
 
-Debian upgrades
-===============
+# Debian upgrades
 
-Major upgrades
---------------
+## Major upgrades
 
 Major upgrades are done by hand, with a "cheat sheet" created for each
 major release. Here are the currently documented ones:
@@ -40,8 +38,7 @@ Team policies:
 
 Some teams might be missing from the list.
 
-Minor upgrades
---------------
+## Minor upgrades
 
 Most of the packages upgrades are handled by the unattended-upgrades package which
 is configured via puppet.