Create a documentation static site

.prettierrc

@@ -0,0 +1,3 @@
+{
+  "proseWrap": "always"
+}

docs/index.md

@@ -0,0 +1,17 @@
+# Macrostrat Python libraries
+
+Welcome to the documentation for the Macrostrat monorepo! This repository
+contains various Python libraries developed by the Macrostrat team. These
+libraries are designed to provide functionality that can be used across
+geoscience software products and applications.
+
+## Libraries
+
+- [`macrostrat.app-frame`](app-frame): A skeleton to scaffold application
+  control scripts
+- [`macrostrat.database`](macrostrat/database.md): Tools to maintain
+  "database-driven" applications, especially PostgreSQL and PostGIS
+- [`macrostrat.dinosaur`](dinosaur): A library for database schema evolution
+- [`macrostrat.utils`](utils): A collection of utility functions
+- [`macrostrat.package-tools`](package-tools): Tools for managing Python
+  packages

docs/macrostrat/app-frame.md

@@ -0,0 +1,30 @@
+# Macrostrat application frame
+
+This is a CLI toolset for managing data and services for a Dockerized
+application. It was originally developed for the
+[Sparrow](https://sparrow-data.org) application, but it has been generalized for
+use with other projects including [Macrostrat](https://macrostrat.org), Mapboard
+and other systems.
+
+It is designed to work well with projects managed using Docker Compose, but may
+eventually acquire features for managing Kubernetes-based applications.
+
+# Basic usage
+
+```python
+app = Application(
+    "Mapboard",
+    restart_commands={"gateway": "caddy reload --config /etc/caddy/Caddyfile"},
+    log_modules=["mapboard.server"],
+    compose_files=[MAPBOARD_ROOT / "system" / "docker-compose.yaml"],
+)
+cli = app.control_command()
+```
+
+The `cli` is a [Typer](https://typer.tiangolo.com/) application that can be used
+to control the system, with abilities to start, stop, and restart services, with
+extension points to add new functionality.
+
+## Application
+
+::: macrostrat.app_frame.Application

docs/macrostrat/database.md

@@ -0,0 +1,7 @@
+# Macrostrat Database
+
+<!-- prettier-ignore-start -->
+## ::: macrostrat.database.Database
+    options:
+      show_root_heading: true
+<!-- prettier-ignore-end -->

mkdocs.yml

@@ -0,0 +1,15 @@
+site_name: Macrostrat Python libraries
+theme:
+  name: "material"
+nav:
+  - Home: "index.md"
+  - Macrostrat:
+      - App Frame: "macrostrat/app-frame.md"
+      - Database: "macrostrat/database.md"
+      - Dinosaur: "macrostrat/dinosaur.md"
+      - Package Tools: "macrostrat/package_tools.md"
+      - Utils: "macrostrat/utils.md"
+
+plugins:
+  - search
+  - mkdocstrings

pyproject.toml

@@ -2,7 +2,8 @@
 authors = ["Daven Quinn <[email protected]>"]
 description = "Macrostrat Python libraries"
 name = "macrostrat.python_libraries"
-version = "1.3.1"
+version = "1.4.0"
+package-mode = false
 
 [tool.poetry.dependencies]
 python = "^3.10"
@@ -20,6 +21,11 @@ requests = "^2.27.1"
 rich = "^13"
 toml = "^0.10.2"
 isort = "^5.13.2"
+mkdocs = "^1.5.3"
+mkdocs-material = "^9.5.3"
+mkdocs-monorepo-plugin = "^1.0.5"
+mkdocstrings = {extras = ["python"], version = "^0.24.1"}
+
 
 [tool.pytest.ini_options]
 addopts = "--confcutdir=."