diff --git a/docs/tutorial/choice.rst b/docs/tutorial/choice.rst
index 3fae85948..85b29b304 100644
--- a/docs/tutorial/choice.rst
+++ b/docs/tutorial/choice.rst
@@ -20,7 +20,7 @@ A variable with possible values
     ::
    
        git clone https://forge.cloud.silique.fr/stove/rougail-tutorials.git
-       git checkout v1.1_010
+       git switch --detach v1.1_010
 
 A variable with a list of possible values
 ---------------------------------------------
diff --git a/docs/tutorial/domainname.rst b/docs/tutorial/domainname.rst
index b6063f7bb..e4794d289 100644
--- a/docs/tutorial/domainname.rst
+++ b/docs/tutorial/domainname.rst
@@ -22,7 +22,7 @@ Some suitable types
     ::
    
        git clone https://forge.cloud.silique.fr/stove/rougail-tutorials.git
-       git checkout v1.1_030
+       git switch --detach v1.1_030
 
 .. type-along:: let's recap how far we've come
 
@@ -199,7 +199,7 @@ This is where the ability to parameterize our variable comes in.
 
     Now you need to checkout the `v1.1_031` version::
      
-          git checkout v1.1_031
+          git switch --detach v1.1_031
 
 Let's add a type parameter named `allow_ip`:
 
@@ -269,7 +269,7 @@ A variable with type `port`
 
     Now you need to checkout the `v1.1_032` version::
      
-          git checkout v1.1_032
+          git switch --detach v1.1_032
 
 
 After the `address` variable let's add, according to our use case,
@@ -381,7 +381,7 @@ A variable with type `boolean`
 
     Now you need to checkout the `v1.1_033` version::
      
-          git checkout v1.1_033
+          git switch --detach v1.1_033
 
 Let's add one more variable in the `manual` family, with a much more basic type: `boolean`.
 
diff --git a/docs/tutorial/family.rst b/docs/tutorial/family.rst
index 5ccfb146f..b80ff5996 100644
--- a/docs/tutorial/family.rst
+++ b/docs/tutorial/family.rst
@@ -25,7 +25,7 @@ Group variables inside families
     ::
    
        git clone https://forge.cloud.silique.fr/stove/rougail-tutorials.git
-       git checkout v1.1_020
+       git switch --detach v1.1_020
 
 .. type-along:: let's recap how far we've come
 
@@ -105,7 +105,7 @@ Or a sub family
 
     Now you need to checkout the `v1.1_021` version::
      
-          git checkout v1.1_021
+          git switch --detach v1.1_021
 
 .. glossary::
 
@@ -141,7 +141,7 @@ Putting a variable inside of a family or a sub family
 
     Now you need to checkout the `v1.1_022` version::
      
-          git checkout v1.1_022
+          git switch --detach v1.1_022
 
 
 We are going to put a variable inside of a family or a sub family
diff --git a/docs/tutorial/preliminary.rst b/docs/tutorial/preliminary.rst
index 1b3c4b2c4..d4629e0c7 100644
--- a/docs/tutorial/preliminary.rst
+++ b/docs/tutorial/preliminary.rst
@@ -25,7 +25,7 @@ Getting started
     ::
    
        git clone https://forge.cloud.silique.fr/stove/rougail-tutorials.git
-       git checkout v1.1_000
+       git switch --detach v1.1_000
       
 Creating a structure file 
 --------------------------
@@ -65,7 +65,7 @@ Let's add our first variable
 
     Now you need to checkout the `v1.1_001` version::
      
-          git checkout v1.1_001
+          git switch --detach v1.1_001
 
 
 - A variable is defined at a minimum by its name.
@@ -134,7 +134,7 @@ Let's add a variable's description, which is not mandatory but which is usually
 
     Now you need to checkout the `v1.1_002` version::
      
-          git checkout v1.1_002
+          git switch --detach v1.1_002
 
 .. extinclude:: https://forge.cloud.silique.fr/stove/rougail-tutorials/raw/tag/v1.1_002/firefox/00-proxy.yml
    :language: yaml
@@ -170,7 +170,7 @@ Set a default value
 
     Now you need to checkout the `v1.1_003` version::
      
-          git checkout v1.1_003
+          git switch --detach v1.1_003
 
 We will learn different ways to set a value, the first way is setting a *default* value.