added sphinx hook to import description of luigi parameters

columnflow/tasks/plotting.py

@@ -250,6 +250,8 @@ class PlotVariablesBaseMultiShifts(
         description="sets the title of the legend; when empty and only one process is present in "
         "the plot, the process_inst label is used; empty default",
     )
+    """
+    """
 
     exclude_index = True
 

docs/conf.py

@@ -110,6 +110,14 @@
     "numpy": ("https://numpy.org/doc/stable/", None),
 }
 
+import luigi
+
+
+def process_docstring(app, what, name, obj, options, lines):
+    if isinstance(obj, luigi.parameter.Parameter):
+        if obj.description:
+            lines.append(f"Description: {obj.description}")
+
 
 def add_intersphinx_aliases_to_inv(app):
     from sphinx.ext.intersphinx import InventoryAdapter
@@ -136,3 +144,5 @@ def setup(app):
     app.add_css_file("styles_common.css")
     if html_theme in ("sphinx_rtd_theme", "alabaster", "sphinx_book_theme"):
         app.add_css_file("styles_{}.css".format(html_theme))
+
+    app.connect("autodoc-process-docstring", process_docstring)