docs: add docstrings to classes and functions

docs/conf.py

@@ -37,7 +37,7 @@
     "source_directory": "docs/",
     "light_logo": "fast-flow-black.png",
     "dark_logo": "fast-flow-white.png",
-    "announcement": "<em>THIS IS WORK IN PROGRESS</em>!",
+    "announcement": 'Interested in contributing? Head to the <a href="https://github.com/FAST-HEP/fasthep-flow">GitHub repository</a> and open a pull request!',
 }
 html_css_files = ["css/custom.css"]
 

src/fasthep_flow/cli.py

@@ -11,20 +11,24 @@
 
 @app.command()
 def lint(config: Path) -> None:
+    """Lint a config file. Throws errors if the config is invalid."""
     typer.echo(f"Linting {config}")
     load_config(config)
     typer.echo("Looks good to me!")
 
 
 @app.command()
 def print_defaults() -> None:
+    """Print the default config."""
     typer.echo("Printing defaults...")
 
 
 @app.command()
 def execute(config: Path) -> None:
+    """Execute a config file."""
     typer.echo(f"Executing {config}...")
 
 
 def main() -> None:
+    """Entrypoint for the CLI."""
     app()

src/fasthep_flow/config.py

@@ -9,6 +9,8 @@
 
 @dataclass
 class StageConfig:
+    """A stage in the workflow."""
+
     name: str
     type: str
     needs: list[str]
@@ -18,10 +20,13 @@ class StageConfig:
 
 @dataclass
 class FlowConfig:
+    """The workflow."""
+
     stages: list[StageConfig]
 
 
 def load_config(config_file: pathlib.Path) -> Any:
+    """Load a config file and return the structured config."""
     schema = OmegaConf.structured(FlowConfig)
     conf = OmegaConf.load(config_file)
     return OmegaConf.merge(schema, conf)