added docs strings

docforge/cli/mkdocs.py

@@ -1,3 +1,8 @@
+"""
+This module contains the 'mkdocs' CLI command, which orchestrates the generation
+of the main mkdocs.yml configuration file.
+"""
+
 from pathlib import Path
 from importlib import resources
 
@@ -10,6 +15,16 @@ from docforge.nav import MkDocsNavEmitter
 
 
 def _load_template(template: Path | None) -> dict:
+    """
+    Load a YAML template for mkdocs.yml. If no template is provided,
+    loads the built-in sample template.
+
+    Args:
+        template: Path to the template file, or None.
+
+    Returns:
+        The loaded template data as a dictionary.
+    """
     if template is not None:
         if not template.exists():
             raise click.FileError(str(template), hint="Template not found")
@@ -59,7 +74,17 @@ def mkdocs_cmd(
     out: Path,
     site_name: str,
 ) -> None:
-    """Generate mkdocs.yml from nav spec and template."""
+    """
+    Generate an mkdocs.yml configuration file by combining a template with
+    the navigation structure resolved from a docforge.nav.yml file.
+
+    Args:
+        docs_dir: Path to the directory containing documentation Markdown files.
+        nav_file: Path to the docforge.nav.yml specification.
+        template: Optional path to an mkdocs.yml template.
+        out: Path where the final mkdocs.yml will be written.
+        site_name: The name of the documentation site.
+    """
 
     if not nav_file.exists():
         raise click.FileError(str(nav_file), hint="Nav spec not found")