diff --git a/docs/.vitepress/sidebar.json b/docs/.vitepress/sidebar.json
index 52cd90d..c16f74e 100644
--- a/docs/.vitepress/sidebar.json
+++ b/docs/.vitepress/sidebar.json
@@ -109,6 +109,10 @@
         "text": "Gestion des équipes",
         "link": "/guide/team"
       },
+      {
+        "text": "Gestion des rôles",
+        "link": "/guide/roles"
+      },
       {
         "text": "Gestion des dépôts",
         "link": "/guide/repositories-management"
diff --git a/docs/guide/roles.md b/docs/guide/roles.md
new file mode 100644
index 0000000..41debab
--- /dev/null
+++ b/docs/guide/roles.md
@@ -0,0 +1,69 @@
+# Gestion des rôles
+
+Les rôles permettent d'augmenter ou diminuer les droits de chaque membre de votre équipe.
+
+Si un membre de l'équipe est associé à plusieurs rôles, il prendra les permissions de tous les rôles associés.
+
+## Rôles du projet
+
+La page Rôles présente la liste des rôles du projet :
+
+![default](/img/guide/roles/default.png)
+
+Par défaut le rôle `Tout le monde` regroupe tous les membres de l'équipe avec les permissions suivantes:
+
+- Reprovisionner le projet
+- Voir les environnements
+- Voir les dépôts
+
+## Créer un rôle
+
+Cliquer sur le bouton `Ajouter un rôle`.
+
+![add_role](/img/guide/roles/add.png)
+
+Le champ de texte `Nom du rôle` permet de choisir le nom du rôle à créer.
+
+Détail des permissions:
+
+- Projet
+  - Gérer le projet: Permet de gérer tout le projet et ses ressources associées
+  - Gérer les rôles du projet: Permet de gérer les rôles du projet et les membres associés (attention, les membres associés peuvent donc gérer leurs propres permissions)
+  - Gérer les membres du projet: Permet d'inviter des utilisateurs et de les retirer
+  - Afficher les secrets: Permet d'afficher les secrets générés par les services (sur la page tableau de bord)
+  - Reprovisionner le projet: Permet de reprovisionner le projet (sur la page tableau de bord)
+
+- Environnements
+  - Gérer les environnement: Permet de créer, éditer, supprimer des environnements
+  - Voir les environnement: Permet de visualiser tous les environnements et leurs configurations
+
+- Dépôts
+  - Gérer les dépôts: Permet de créer, éditer, supprimer des dépôts
+  - Voir les dépôts: Permet de visualiser tous les dépôts et leurs configurations
+
+Cliquer sur le bouton `Enregistrer` pour créer le rôle.
+
+## Assigner/Retirer un membre à un rôle
+
+Cliquer sur le rôle voulu et aller dans l'onglet `Membres`
+
+![Menu](/img/guide/roles/membres.png)
+
+Dans l'exemple, Aurahan est associé au rôle Dev.
+
+Les modifications concernant les membres d'un rôle sont sauvegardées automatiquement.
+
+Il est possible de retrouver un récapitulatif des rôles associés aux membres du projet sur la page `Equipes`:
+
+![Menu](/img/guide/roles/recap_membres_projet.png)
+
+Ici:
+
+- Baptiste est le créateur du projet
+- Pierre a le rôle ops
+- Aurahan a les rôles dev et PO
+
+## Supprimer un rôle
+
+Pour supprimer un rôle, sélectionner celui-ci dans la liste des rôles et cliquer sur le bouton `Supprimer`
+
diff --git a/docs/public/img/guide/roles/add.png b/docs/public/img/guide/roles/add.png
new file mode 100644
index 0000000..5e7c5dc
Binary files /dev/null and b/docs/public/img/guide/roles/add.png differ
diff --git a/docs/public/img/guide/roles/default.png b/docs/public/img/guide/roles/default.png
new file mode 100644
index 0000000..f690df3
Binary files /dev/null and b/docs/public/img/guide/roles/default.png differ
diff --git a/docs/public/img/guide/roles/membres.png b/docs/public/img/guide/roles/membres.png
new file mode 100644
index 0000000..bb954be
Binary files /dev/null and b/docs/public/img/guide/roles/membres.png differ
diff --git a/docs/public/img/guide/roles/recap_membres_projet.png b/docs/public/img/guide/roles/recap_membres_projet.png
new file mode 100644
index 0000000..6b9f41d
Binary files /dev/null and b/docs/public/img/guide/roles/recap_membres_projet.png differ