docs(mail_intake): add MkDocs navigation and API reference document structure

- docs(mkdocs.yml): define navigation structure for mail_intake modules
- docs(mkdocs.yml): configure mkdocstrings for Python API rendering
- docs(docs): add documentation root and mail_intake index page
- docs(docs): add adapters documentation pages with mkdocstrings directives
- docs(docs): add auth documentation pages with mkdocstrings directives
- docs(docs): add ingestion documentation pages with mkdocstrings directives
- docs(docs): add models documentation pages with mkdocstrings directives
- docs(docs): add parsers documentation pages with mkdocstrings directives
- docs(docs): add config and exceptions documentation pages

docs/mail_intake/adapters/base.md

@@ -0,0 +1,3 @@
+# Base
+
+::: mail_intake.adapters.base

docs/mail_intake/adapters/gmail.md

@@ -0,0 +1,3 @@
+# Gmail
+
+::: mail_intake.adapters.gmail

docs/mail_intake/adapters/index.md

@@ -0,0 +1,3 @@
+# Adapters
+
+::: mail_intake.adapters

docs/mail_intake/auth/base.md

@@ -0,0 +1,3 @@
+# Base
+
+::: mail_intake.auth.base

docs/mail_intake/auth/google.md

@@ -0,0 +1,3 @@
+# Google
+
+::: mail_intake.auth.google

docs/mail_intake/auth/index.md

@@ -0,0 +1,3 @@
+# Auth
+
+::: mail_intake.auth

docs/mail_intake/config.md

@@ -0,0 +1,3 @@
+# Config
+
+::: mail_intake.config

docs/mail_intake/exceptions.md

@@ -0,0 +1,3 @@
+# Exceptions
+
+::: mail_intake.exceptions

docs/mail_intake/index.md

@@ -0,0 +1,3 @@
+# Mail Intake
+
+::: mail_intake

docs/mail_intake/ingestion/index.md

@@ -0,0 +1,3 @@
+# Ingestion
+
+::: mail_intake.ingestion

docs/mail_intake/ingestion/reader.md

@@ -0,0 +1,3 @@
+# Reader
+
+::: mail_intake.ingestion.reader

docs/mail_intake/models/index.md

@@ -0,0 +1,3 @@
+# Models
+
+::: mail_intake.models

docs/mail_intake/models/message.md

@@ -0,0 +1,3 @@
+# Message
+
+::: mail_intake.models.message

docs/mail_intake/models/thread.md

@@ -0,0 +1,3 @@
+# Thread
+
+::: mail_intake.models.thread

docs/mail_intake/parsers/body.md

@@ -0,0 +1,3 @@
+# Body
+
+::: mail_intake.parsers.body

docs/mail_intake/parsers/headers.md

@@ -0,0 +1,3 @@
+# Headers
+
+::: mail_intake.parsers.headers

docs/mail_intake/parsers/index.md

@@ -0,0 +1,3 @@
+# Parsers
+
+::: mail_intake.parsers

docs/mail_intake/parsers/subject.md

@@ -0,0 +1,3 @@
+# Subject
+
+::: mail_intake.parsers.subject

mkdocs.yml

@@ -0,0 +1,61 @@
+site_name: Aetoskia Mail Intake
+site_description: Format-agnostic document reading, parsing, and scraping framework
+
+theme:
+  name: material
+  palette:
+    - scheme: slate
+      primary: deep purple
+      accent: cyan
+  font:
+    text: Inter
+    code: JetBrains Mono
+  features:
+    - navigation.tabs
+    - navigation.expand
+    - navigation.top
+    - navigation.instant
+    - content.code.copy
+    - content.code.annotate
+
+plugins:
+  - search
+  - mkdocstrings:
+      handlers:
+        python:
+          paths: ["."]
+          options:
+            docstring_style: google
+            show_source: false
+            show_signature_annotations: true
+            separate_signature: true
+            merge_init_into_class: true
+            inherited_members: true
+            annotations_path: brief
+            show_root_heading: true
+            group_by_category: true
+
+nav:
+  - Home: mail_intake/index.md
+
+  - Adapters:
+      - Base Adapter: mail_intake/adapters/base.md
+      - Gmail Adapter: mail_intake/adapters/gmail.md
+
+  - Auth:
+      - Base Auth: mail_intake/auth/base.md
+      - Google Auth: mail_intake/auth/google.md
+
+  - Mail Reader: mail_intake/ingestion/reader.md
+
+  - Models:
+      - Message: mail_intake/models/message.md
+      - Thread: mail_intake/models/thread.md
+
+  - Parsers:
+      - Body: mail_intake/parsers/body.md
+      - Headers: mail_intake/parsers/headers.md
+      - Subject: mail_intake/parsers/subject.md
+
+  - Config: mail_intake/config.md
+  - Exceptions: mail_intake/exceptions.md