Merge pull request #2 from KooshaPari/org-github/feat/docs-site

feat(docs): add organization docs site skeleton

Author: KooshaPari

.github/workflows/deploy-docs.yml

@@ -0,0 +1,19 @@
+name: Deploy docs
+on: { push: { branches: [ main, master ] } }
+
+permissions:
+  contents: write
+
+jobs:
+  build:
+    runs-on: ubuntu-24.04
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: npm
+      - run: npm ci
+      - run: npm run docs:build
+      - uses: peaceiris/actions-gh-pages@v4
+        with: { github_token: ${{ secrets.GITHUB_TOKEN }}, publish_dir: ./docs/.vitepress/dist }

PLAN.md

@@ -0,0 +1,27 @@
+# org-github Plan
+
+## Overview
+Reusable workflows and templates for Phenotype ecosystem.
+
+## Phases
+
+### Phase 1: CI Workflows (1 week)
+- Rust CI workflow
+- Python CI workflow
+- TypeScript CI workflow
+
+### Phase 2: Advanced Workflows (2 weeks)
+- Security scanning workflow
+- Package publishing workflow
+- Release creation workflow
+
+### Phase 3: Templates (1 week)
+- Issue templates
+- PR templates
+- Contributing guidelines
+
+## Deliverables
+- 4 reusable CI workflows
+- Security scanning pipeline
+- Multi-registry publishing
+- Issue and PR templates

SPEC.md

@@ -0,0 +1,41 @@
+# org-github Specification
+
+## Architecture
+```
+┌─────────────────────────────────────────────────────┐
+│            org-github (GitHub Org Templates)       │
+├─────────────────────────────────────────────────────┤
+│  ┌───────────────────────────────────────────────┐ │
+│  │         Repository Templates                 │ │
+│  │  ┌─────────────┐ ┌────────────────────────┐   │ │
+│  │  │ ISSUE_TEMPLATE│ │ PULL_REQUEST_TEMPLATE │   │ │
+│  │  └─────────────┘ └────────────────────────┘   │ │
+│  │  ┌─────────────┐ ┌────────────────────────┐   │ │
+│  │  │    docs/    │ │  CODE_OF_CONDUCT.md    │   │ │
+│  │  └─────────────┘ └────────────────────────┘   │ │
+│  └───────────────────────────────────────────────┘ │
+└─────────────────────────────────────────────────────┘
+```
+
+## Templates
+
+| Template | Purpose |
+|----------|---------|
+| ISSUE_TEMPLATE | Bug/feature report |
+| PULL_REQUEST_TEMPLATE | PR description |
+| CODE_OF_CONDUCT.md | Community guidelines |
+| CONTRIBUTING.md | Contribution guide |
+| FUNDING.yml | Funding options |
+
+## Data Models
+
+```yaml
+issue:
+  type: bug | feature
+  priority: critical | high | medium | low
+  area: api | docs | infra
+
+pr:
+  type: feat | fix | refactor | docs
+  scope: none | breaking
+```

docs/.vitepress/config.ts

@@ -0,0 +1 @@
+export default { title: "Documentation", themeConfig: { nav: [{ text: 'Guide', link: '/guide/' }] } };

docs/index.md

@@ -0,0 +1,7 @@
+---
+title: Documentation
+---
+
+# Getting started
+
+This repo now has a VitePress documentation skeleton.

docs/journeys/core-integration.md

@@ -0,0 +1,12 @@
+---
+layout: doc
+title: Core Integration
+---
+
+# Core Integration
+
+This journey is reserved for the organization profile documentation integration path.
+
+## Status
+
+Planned.

docs/journeys/production-setup.md

@@ -0,0 +1,12 @@
+---
+layout: doc
+title: Production Setup
+---
+
+# Production Setup
+
+This journey is reserved for the production documentation publishing path.
+
+## Status
+
+Planned.

docs/stories/integration.md

@@ -0,0 +1,12 @@
+---
+layout: doc
+title: Integration
+---
+
+# Integration
+
+This story is reserved for an end-to-end organization documentation integration example.
+
+## Status
+
+Planned.