Merge branch 'feature/twidi/domain-repository-for-code_repository-con…

…text' into develop

.gitignore

@@ -72,6 +72,7 @@ instance/
 
 # Sphinx documentation
 docs/_build/
+docs/_build_txt/
 # Doc from code
 docs/source/
 # Doc from bdd features

docs/_static/css/gherkin.css

@@ -1,8 +1,10 @@
 /* Style for doc generated by `sphinx-gherkindoc` */
-div[id^="scenario-"] h2 ~ * {
+div[id^="feature-"].section div[id^="scenario-"] h2 ~ *,
+div[id^="feature-"].section div[id^="background-"] h2 ~ * {
   margin-left: 2em !important;
 }
-.gherkin-scenario-content {
+.gherkin-scenario-content,
+.gherkin-background-content {
     font-weight: normal;
 }
 .gherkin-step-keyword {

docs/conf.py

@@ -93,6 +93,7 @@
 # -- Run apidoc when building the documentation-------------------------------
 
 napoleon_use_ivar = True
+autodoc_member_order = "bysource"
 add_module_names = False
 
 
@@ -140,7 +141,7 @@ def run_gherkindoc(_):
             "--toc-name",
             "index",
             "--maxtocdepth",
-            "5",
+            "4",  # avoid scenarios for ``isshub.domain.contexts`` (may to too much/not enough later)
         ]
     )
 
@@ -158,7 +159,15 @@ def run_gherkindoc(_):
         rst_file = os.path.join(output_path, f"{base_name}-toc.rst")
         with open(rst_file, "r") as file_d:
             rst_lines = file_d.readlines()
-        rst_lines.insert(3, f".. graphviz:: {base_name}-entities.dot\n\n")
+        rst_lines.insert(
+            3,
+            "Diagrams\n--------\n\n"
+            "Entities\n~~~~~~~~\n\n"
+            f".. graphviz:: {base_name}-entities.dot\n\n"
+            "Repositories\n~~~~~~~~~~~~\n\n"
+            f".. graphviz:: {base_name}-repositories.dot\n\n"
+            "BDD features\n------------\n\n",
+        )
         with open(rst_file, "w") as file_d:
             file_d.write("".join(rst_lines))