Forms doc improve (#80)

* Improve a bit the doc for forms

* Add PR template

.github/PULL_REQUEST_TEMPLATE

@@ -0,0 +1,21 @@
+## 🎯 Objectif
+
+_Un résumé de l’objectif de la PR_
+
+_Précisez si c’est un bugfix, une nouvelle fonctionnalité… Expliquez rapidement le gain « fonctionnel » de vos modifications._
+
+## 🔍 Implémentation
+
+- _Une liste des modifications_
+
+## ⚠️ Informations supplémentaires
+
+_(optionnel) Documentation, commandes à lancer, variables d’environnement, etc._
+
+## 🏕 Amélioration continue
+
+- _(optionnel) Une liste d’autres modifications pas en lien direct avec la PR_
+
+## 🖼️ Images
+
+_(optionnel) Une ou plusieurs captures d’écran, si pertinent_

doc/forms.md

@@ -1,3 +1,6 @@
+# Formulaires – Documentation
+
+## Initialisation des formulaires
 Les formulaires sont construits en se basant sur la classe `DsfrBaseForm`, par exemple :
 
 ```{ .python }
@@ -23,9 +26,10 @@ Il est possible de multi-classer :
 class AuthorCreateForm(ModelForm, DsfrBaseForm):
 ```
 
+## Classes CSS
 Le formulaire ajoute la ou les classes appropriées (`fr-input`, `fr-select`, etc.) en fonction du type de champ, mais uniquement si une classe n’a pas déjà été ajoutée.
 
-Si c'est le cas, il faut aussi forcer manuellement les classes à utiliser :
+Si c’est le cas, il faut soit forcer manuellement les classes à utiliser :
 
 ```{ .python }
     password = forms.CharField(
@@ -35,5 +39,16 @@ Si c'est le cas, il faut aussi forcer manuellement les classes à utiliser :
             "class": "fr-input my-custom-class"
         )
     )
+```
+
+soit les ajouter dans la méthode `init` du formulaire (en faisant attention à laisser une espace au début) :
+
+```{ .python }
+class AuthorCreateForm(ModelForm, DsfrBaseForm):
+
+# [...]
 
+def __init__(self, *args, **kwargs):
+    super().__init__(*args, **kwargs)
+    self.fields["password"].widget.attrs["class"] += " my custom class"
 ```

example_app/views.py

@@ -352,7 +352,7 @@ def doc_install(request):
 
 @require_safe
 def doc_form(request):
-    payload = init_payload("Installation")
+    payload = init_payload("Formulaires – Documentation")
     payload["documentation"] = format_markdown_from_file("doc/forms.md")
 
     return render(request, "example_app/doc_markdown.html", payload)