Fix pre-commit documentation and configuration file

Author: Nicoretti

.pre-commit-config.yaml

@@ -1,15 +1,23 @@
-default_stages: [ commit ]
+default_stages: [ commit, push ]
 repos:
 
   - repo: local
     hooks:
       - id: code-format
         name: code-format
         types: [ python ]
-        files: "pyproject.toml"
         pass_filenames: false
         language: system
-        entry: poetry run nox -s fix
+        entry: poetry run nox -s project:fix
+        stages: [ commit ]
+
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v4.4.0
+    stages: [ commit ]
+    hooks:
+      - id: check-yaml
+      - id: end-of-file-fixer
+      - id: trailing-whitespace
 
   - repo: local
     hooks:
@@ -18,7 +26,8 @@ repos:
         types: [ python ]
         pass_filenames: false
         language: system
-        entry: poetry run nox -s type-check
+        entry: poetry run nox -s lint:typing
+        stages: [ push ]
 
   - repo: local
     hooks:
@@ -27,11 +36,5 @@ repos:
         types: [ python ]
         pass_filenames: false
         language: system
-        entry: poetry run nox -s lint
-
-  - repo: https://github.com/pre-commit/pre-commit-hooks
-    rev: v4.4.0
-    hooks:
-      - id: check-yaml
-      - id: end-of-file-fixer
-      - id: trailing-whitespace
+        entry: poetry run nox -s lint:code
+        stages: [ push ]

doc/user_guide/getting_started.rst

@@ -161,10 +161,12 @@ forward and you just can use the example *noxfile.py* bellow.
 
 
 
-6. Setup the pre-commit hooks
-+++++++++++++++++++++++++++++
+6. Setup the pre-commit hooks [optional]
+++++++++++++++++++++++++++++++++++++++++
 
-#. Add the following .pre-commit-config.yaml to your project root
+#. Add a :code:`.pre-commit-config.yaml` file to your project root
+
+    If you want to reuse Nox tasks in the pre-commit hooks, feel free to get some inspiration from the Python toolbox itself:
 
     .. literalinclude:: ../../.pre-commit-config.yaml
        :language: yaml