From a6c9cf11bd3156d5c5d35a309b4bc8f55c567e8e Mon Sep 17 00:00:00 2001
From: Ludovic Stephan <ludovic.stephan@ens.fr>
Date: Sun, 26 Jul 2020 22:02:14 +0200
Subject: [PATCH] Meilleure doc

---
 bds/mixins.py | 16 +++++++++++++++-
 1 file changed, 15 insertions(+), 1 deletion(-)

diff --git a/bds/mixins.py b/bds/mixins.py
index 30334e9f..473bb0b4 100644
--- a/bds/mixins.py
+++ b/bds/mixins.py
@@ -11,7 +11,21 @@ class StaffRequiredMixin(PermissionRequiredMixin):
 class MultipleFormMixin(ContextMixin):
     """ Mixin pour gérer plusieurs formulaires dans la même vue.
     Le fonctionnement est relativement identique à celui de
-    FormMixin.
+    FormMixin, dont la documentation est disponible ici :
+    https://docs.djangoproject.com/en/3.0/ref/class-based-views/mixins-editing/
+
+    Les principales différences sont :
+    - au lieu de form_class, il faut donner comme attribut un dict de la forme
+    {<form_name>: <form_class>}, avec tous les formulaires à instancier. On
+    peut aussi redéfinir `get_form_classes`
+
+    - les données initiales se récupèrent pour chaque form via l'attribut
+    `<form_name>_initial` ou la fonction `get_<form_name>_initial`. De même,
+    si certaines forms sont des `ModelForm`s, on peut définir la fonction
+    `get_<form_name>_instance`.
+
+    - chaque form a un préfixe rajouté, par défaut <form_name>, mais qui peut
+    être customisé via `prefixes` ou `get_prefixes`.
     """
 
     form_classes = {}