Merge branch 'main' into feat/convert-to-zensical

Author: RemoteRabbit

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,59 @@
+name: Bug report
+description: Something is broken or behaving unexpectedly.
+title: "fix: <short description>"
+labels: ["bug"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for filing a bug. Please include enough info to reproduce it.
+
+  - type: textarea
+    id: summary
+    attributes:
+      label: Summary
+      description: What happened? What did you expect to happen?
+      placeholder: |
+        When I run `make docs` the build fails with ...
+        I expected the site to build successfully.
+    validations:
+      required: true
+
+  - type: textarea
+    id: repro
+    attributes:
+      label: Steps to reproduce
+      description: Minimal commands or actions that trigger the bug.
+      placeholder: |
+        1. Clone the repo
+        2. Run `uv sync`
+        3. Run `make docs`
+      render: bash
+    validations:
+      required: true
+
+  - type: textarea
+    id: logs
+    attributes:
+      label: Logs / output
+      description: Paste any relevant error output. Sensitive values should be redacted.
+      render: text
+
+  - type: input
+    id: version
+    attributes:
+      label: Commit / version
+      description: Output of `git rev-parse --short HEAD` or release tag.
+
+  - type: input
+    id: env
+    attributes:
+      label: Environment
+      description: OS, Python version, tool versions, etc.
+      placeholder: "Arch Linux, Python 3.12, uv 0.4.x"
+
+  - type: textarea
+    id: notes
+    attributes:
+      label: Additional context
+      description: Anything else worth mentioning.

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1 @@
+blank_issues_enabled: true

.github/ISSUE_TEMPLATE/docs.yml

@@ -0,0 +1,26 @@
+name: Docs issue
+description: Missing, incorrect, or unclear documentation.
+title: "docs: <short description>"
+labels: ["documentation"]
+body:
+  - type: input
+    id: location
+    attributes:
+      label: Page / file
+      description: Path under `docs/` or URL of the page.
+      placeholder: "docs/getting-started.md"
+    validations:
+      required: true
+
+  - type: textarea
+    id: problem
+    attributes:
+      label: What's wrong or missing?
+    validations:
+      required: true
+
+  - type: textarea
+    id: suggestion
+    attributes:
+      label: Suggested change
+      description: Optional. Wording, structure, or new section idea.

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,32 @@
+name: Feature request
+description: Suggest a new capability, section, or improvement.
+title: "feat: <short description>"
+labels: ["enhancement"]
+body:
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem / motivation
+      description: What are you trying to do? Why does the current setup fall short?
+    validations:
+      required: true
+
+  - type: textarea
+    id: proposal
+    attributes:
+      label: Proposed solution
+      description: What would you like added or changed?
+    validations:
+      required: true
+
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives considered
+      description: Other approaches you thought about.
+
+  - type: textarea
+    id: notes
+    attributes:
+      label: Additional context
+      description: Links, screenshots, references, examples from other projects.