merge upstream

docs/maintainers/index.md

@@ -18,9 +18,9 @@ Welcome to the recipe maintainers guide! Recipe maintainers help build up and ma
 
     [Get Started](/maintainers/tutorial){ .md-button .md-button--primary }
 
-- __How to Upgrade a Recipe__
+- __Recipe config upgrade checklist__
 
-    If you want to upgrade a recipe, start here 🤸‍♀️
+    If you want to upgrade a recipe config, please make sure you take these steps into consideration 🤸‍♀️
 
     [Start upgrading](/maintainers/upgrade){ .md-button .md-button--primary }
 

docs/maintainers/tutorial.md

@@ -1,9 +1,7 @@
 ---
-title: New maintainers tutorial
+title: Package your First Recipe Tutorial
 ---
 
-## Package your first recipe
-
 ### Overview
 
 Packaging a recipe is basically knowing a bag of about 20 tricks. Once you learn them, there is nothing more to learn. It can seem daunting at first but it's simple and easy to do once you know the tricks.

docs/maintainers/upgrade.md

@@ -1,5 +1,5 @@
 ---
-title: How to Upgrade a Recipe
+title: Recipe config upgrade checklist
 ---
 
 !!! warning "The recipe config commons is people!"

mkdocs.yml

@@ -73,7 +73,9 @@ nav:
       - "Support Us": intro/support.md
   - "Maintainers":
       - maintainers/index.md
-      - "New Maintainers Tutorial": maintainers/tutorial.md
+      - "How to Become a Recipe Maintainer": maintainers/maintain.md
+      - "Package your First Recipe Tutorial": maintainers/tutorial.md
+      - "Recipe config upgrade checklist": maintainers/upgrade.md
       - "Packaging Handbook": maintainers/handbook.md
       - maintainers/catalogue.md
   - "Operators":