Add MkDocs Material documentation site with full API reference

Set up a complete GitHub Pages documentation site using MkDocs Material with
auto-generated API reference from enriched NumPy-style docstrings. This adds
~24 new doc files (landing page, getting started, CLI reference, 14 API stubs,
notebooks, citation) and enriches docstrings across ~50 source files covering
all public classes, functions, and methods. Includes a GitHub Actions workflow
for automatic deployment on push to main.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: jman41

.github/workflows/docs.yml

@@ -0,0 +1,44 @@
+name: Deploy Docs
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
+jobs:
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install dependencies
+        run: pip install -e ".[docs]"
+
+      - name: Build docs
+        run: mkdocs build --strict
+
+      - uses: actions/configure-pages@v5
+
+      - uses: actions/upload-pages-artifact@v3
+        with:
+          path: site/
+
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

.gitignore

@@ -37,5 +37,8 @@ artifacts/
 # Secrets
 .env
 
+# MkDocs build output
+site/
+
 # Large reference docs
 background_information.md

docs/api/antenna.md

@@ -0,0 +1,28 @@
+# Antenna
+
+Antenna gain models implementing the [`AntennaModel`][opensatcom.core.protocols.AntennaModel] protocol.
+
+## Parametric Antenna
+
+::: opensatcom.antenna.parametric.ParametricAntenna
+
+## Cosine Rolloff Antenna
+
+::: opensatcom.antenna.cosine.CosineRolloffAntenna
+
+## PAM Array Antenna
+
+::: opensatcom.antenna.pam.PamArrayAntenna
+
+## Coupling-Aware Antenna
+
+::: opensatcom.antenna.coupling.CouplingAwareAntenna
+
+## EdgeFEM Loader
+
+::: opensatcom.antenna.edgefem_loader
+    options:
+      members:
+        - CouplingData
+        - load_npz_artifact
+        - load_touchstone_coupling

docs/api/core/models.md

@@ -0,0 +1,18 @@
+# Models
+
+Core datamodels used throughout OpenSatCom — terminals, scenarios, link inputs/outputs, and RF chain parameters.
+
+::: opensatcom.core.models
+    options:
+      members:
+        - Terminal
+        - Scenario
+        - PropagationConditions
+        - ModCod
+        - StateECEF
+        - OpsPolicy
+        - LinkInputs
+        - LinkOutputs
+        - RFChainModel
+        - WorldSimInputs
+        - WorldSimOutputs

docs/api/core/protocols.md

@@ -0,0 +1,14 @@
+# Protocols
+
+Protocol-based interfaces defining the public API contracts for OpenSatCom. All pluggable components implement these protocols.
+
+::: opensatcom.core.protocols
+    options:
+      members:
+        - AntennaModel
+        - PropagationModel
+        - PerformanceCurve
+        - ACMPolicy
+        - LinkEngine
+        - TrajectoryProvider
+        - EnvironmentProvider

docs/api/core/units.md

@@ -0,0 +1,11 @@
+# Units & Constants
+
+Unit conversion utilities and physical constants used throughout OpenSatCom.
+
+## Unit Conversions
+
+::: opensatcom.core.units
+
+## Physical Constants
+
+::: opensatcom.core.constants

docs/api/geometry.md

@@ -0,0 +1,9 @@
+# Geometry
+
+Geometric calculations for satellite-terminal links — slant range and elevation angle.
+
+::: opensatcom.geometry.slant
+    options:
+      members:
+        - slant_range_m
+        - elevation_deg

docs/api/io.md

@@ -0,0 +1,35 @@
+# I/O & Config
+
+YAML configuration loading, validation, and run artifact management.
+
+## Config Loader
+
+::: opensatcom.io.config_loader
+    options:
+      members:
+        - load_config
+        - ProjectConfig
+        - ProjectSection
+        - ScenarioSection
+        - TerminalSection
+        - TerminalsSection
+        - AntennaSection
+        - AntennaEndConfig
+        - ParametricAntennaConfig
+        - PamAntennaConfig
+        - CouplingConfig
+        - RFChainSection
+        - RFStageConfig
+        - PropagationSection
+        - PropagationComponentConfig
+        - ModemSection
+        - WorldSection
+        - WorldOpsPolicy
+        - ReportsSection
+        - PayloadSection
+        - BeamConfig
+        - CosineAntennaConfig
+
+## Run Context
+
+::: opensatcom.io.workspace.RunContext

docs/api/link.md

@@ -0,0 +1,5 @@
+# Link Engine
+
+Snapshot link budget evaluation — the central API that computes EIRP, G/T, C/N0, Eb/N0, and margin.
+
+::: opensatcom.link.engine.DefaultLinkEngine

docs/api/modem.md

@@ -0,0 +1,25 @@
+# Modem
+
+DVB-S2 modem models — ModCod tables, performance curves, ACM policies, and throughput computation.
+
+## Modem Model
+
+::: opensatcom.modem.modem.ModemModel
+
+## DVB-S2 Built-in Tables
+
+::: opensatcom.modem.dvbs2
+    options:
+      members:
+        - get_dvbs2_modcod_table
+        - get_dvbs2_performance_curves
+
+## Performance Curves
+
+::: opensatcom.modem.curves.TablePerformanceCurve
+
+::: opensatcom.modem.analytic_curves.AnalyticBERCurve
+
+## ACM Policy
+
+::: opensatcom.modem.acm.HysteresisACMPolicy