Initial: ITPP standards repo with templates, CI workflows, .gitignore, and .markdownlint.json

templates/design-template.md

@@ -0,0 +1,26 @@
+# {{PROJECT_NAME}} — Design
+
+> **Status:** DRAFT
+> **Last Updated:** YYYY-MM-DD
+
+## Overview
+
+<What this design document covers and who it is for.>
+
+## Architecture
+
+<High-level architecture description. Diagrams welcome.>
+
+## API / Interface
+
+<Public API surface, data models, integration points.>
+
+## Decisions
+
+| Date | Decision | Rationale |
+|---|---|---|
+| YYYY-MM-DD | <decision> | <why> |
+
+## Consumers
+
+<Who depends on this project and how they use it.>

templates/gitea-ci/docs-check.yml

@@ -0,0 +1,26 @@
+name: Docs Check
+on:
+  push:
+    paths:
+      - '**.md'
+      - 'docs/**'
+  pull_request:
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Markdown lint
+        run: |
+          npm install -g markdownlint-cli
+          markdownlint '**/*.md' --ignore node_modules
+      - name: Link check
+        run: |
+          npm install -g markdown-link-check
+          find . -name '*.md' -not -path '*/node_modules/*' \
+            -exec markdown-link-check {} \;
+      - name: Spell check
+        run: |
+          pip install codespell
+          codespell '**/*.md' --skip='*.git*'

templates/gitea-ci/docs-publish.yml

@@ -0,0 +1,20 @@
+name: Publish Docs Site
+on:
+  push:
+    branches: [main]
+  schedule:
+    - cron: '0 5 * * *'
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Build MkDocs site
+        run: |
+          pip install mkdocs mkdocs-material
+          bash build-docs.sh
+          mkdocs build
+      - name: Deploy to app3
+        run: |
+          rsync -avz site/ root@152.53.241.111:/var/www/docs.itpropartner.com/

templates/mkdocs.yml

@@ -0,0 +1,33 @@
+site_name: "{{PROJECT_NAME}} Docs"
+site_url: "https://docs.itpropartner.com/{{PROJECT_NAME}}/"
+repo_url: "https://git.itpropartner.com/ippadmin/{{PROJECT_NAME}}"
+edit_uri: edit/main/docs/
+
+theme:
+  name: material
+  palette:
+    scheme: slate
+    primary: indigo
+    accent: indigo
+  features:
+    - navigation.instant
+    - navigation.tracking
+    - navigation.tabs
+    - navigation.sections
+    - search.highlight
+    - search.share
+
+plugins:
+  - search
+
+markdown_extensions:
+  - admonition
+  - pymdownx.details
+  - pymdownx.superfences
+  - pymdownx.highlight
+  - tables
+  - toc:
+      permalink: true
+
+nav:
+  - Home: index.md

templates/repo-changelog.md

@@ -0,0 +1,5 @@
+# {{PROJECT_NAME}} — CHANGELOG
+
+## YYYY-MM-DD — Initial
+
+- Created project repository.

templates/repo-readme.md

@@ -0,0 +1,29 @@
+# {{PROJECT_NAME}}
+
+> **Owner:** Germaine | **Status:** PLANNED
+> **Last Updated:** YYYY-MM-DD
+
+<One-paragraph summary of what this project does and why it exists.>
+
+## Access
+
+| Resource | URL | Location | Notes |
+|---|---|---|---|
+| <service name> | https://... | <server> | <how to auth> |
+
+## Tech Stack
+
+<Bullet list: Python 3.11, FastAPI, SQLite, Docker, etc.>
+
+## Quick Start
+
+```bash
+git clone https://git.itpropartner.com/ippadmin/{{PROJECT_NAME}}.git
+cd {{PROJECT_NAME}}
+# how to run / deploy
+```
+
+## Related
+
+- [itpp-infrastructure](https://git.itpropartner.com/ippadmin/itpp-infrastructure) — server inventory, DNS
+- [itpp-standards](https://git.itpropartner.com/ippadmin/itpp-standards) — docs standards and templates