feat: add MkDocs Material documentation scaffolding

- Add docs dependency group (mkdocs-material, mkdocstrings)
- Add mkdocs.yml with Material theme config
- Add placeholder docs/index.md and docs/reference.md
- All docs files are conditional on include_docs copier variable

Co-Authored-By: Claude Opus 4.6 <[email protected]>

Author: phinate

project_template/pyproject.toml

@@ -50,6 +50,12 @@ test = [
 lint = [
   "ruff>=0.15",
 ]
+{%- if include_docs %}
+docs = [
+  "mkdocs-material>=9.0",
+  "mkdocstrings[python]>=0.27",
+]
+{%- endif %}
 
 [project.urls]
 Homepage = "{{ url }}"

project_template/{% if include_docs %}docs{% endif %}/index.md

@@ -0,0 +1,5 @@
+# {{ project_name }}
+
+{{ project_short_description }}
+
+<!-- TODO: Add project overview, installation instructions, and quickstart guide. -->

project_template/{% if include_docs %}docs{% endif %}/reference.md

@@ -0,0 +1,3 @@
+# API Reference
+
+::: {{ python_name }}

project_template/{% if include_docs %}mkdocs.yml{% endif %}

@@ -0,0 +1,26 @@
+site_name: "{{ project_name }}"
+site_url: "https://{{ org }}.github.io/{{ project_name }}"
+repo_url: "{{ url }}"
+
+theme:
+  name: material
+  features:
+    - content.code.copy
+    - navigation.sections
+    - search.highlight
+
+plugins:
+  - search
+  - mkdocstrings:
+      handlers:
+        python:
+          paths: [src]
+
+nav:
+  - Home: index.md
+  - API Reference: reference.md
+
+markdown_extensions:
+  - admonition
+  - pymdownx.highlight
+  - pymdownx.superfences