.pre-commit-config.yaml

 repos:
   - repo: https://github.com/PyCQA/isort
-    rev: 5.10.1
+    rev: 5.12.0
     hooks:
       - id: isort
         args: ["--profile", "black"]
   - repo: https://github.com/ambv/black
-    rev: 22.10.0
+    rev: 22.12.0
     hooks:
     - id: black
   - repo: https://github.com/pycqa/flake8
@@ -40,7 +40,7 @@ repos:
       - id: codespell
         args: ['--write-changes']
   - repo: https://github.com/PyCQA/doc8
-    rev: v1.0.0
+    rev: v1.1.1
     hooks:
       - id: doc8
   - repo: meta

dan/ocr/line/__init__.py

@@ -7,7 +7,7 @@ from dan.ocr.line.train import run as run_train
 def add_generate_parser(subcommands) -> None:
     parser = subcommands.add_parser(
         "generate",
-        description=__doc__,
+        description="Generate synthetic data to train DAN models.",
         help="Generate synthetic data to train DAN models.",
     )
     parser.set_defaults(func=run_generate)
@@ -16,7 +16,7 @@ def add_generate_parser(subcommands) -> None:
 def add_line_parser(subcommands) -> None:
     parser = subcommands.add_parser(
         "line",
-        description=__doc__,
+        description="Train a DAN model at line level.",
         help="Train a DAN model at line level.",
     )
     parser.set_defaults(func=run_train)

docs/usage/train.md

@@ -2,6 +2,14 @@
 
 Use the `teklia-dan train` command to train a new DAN model.
 
+Two subcommands are available depending on your dataset:
+
+`line`
+: Train a DAN model at line-level.
+
+`document`
+: Train a DAN model at document-level.
+
 ## Remarks (for pre-training and training)
 All hyperparameters are specified and editable in the training scripts (meaning are in comments).