Files
openyield/mkdocs.yml
T
cloudinit-bot 82ae6cf5a2 docs(milestone): complete OpenYield v0.3 (Bearers & Documentation)
Milestone v0.3 complete. Feature type, tags v0.2.x. Two work-streams
shipped under one feature milestone:

(A) Bearers skeleton + tests (D-020 pattern, 7 x/* packages, zero ext deps):
- x/bridge (NEW): BridgeStatus enum (4), BridgeRoute by-ID-string refs
- x/exit (NEW): ExitStatus enum (5), ExitRoute, DEXSwap (opaque venue)
- x/bearers (EXT): OYSATLink surveillance-resistant LOCKED, OYQRCode idempotent
- x/partner (EXT): AnchorCredential (custody-provider-id empty in skeleton)
- x/hub (NEW): HubService enum (3), LendingCouponCapBps=800 LOCAL const (A-304)
- x/services (NEW): ServiceKind enum (4), window-id by-ID-string ref (A-307)
- x/bond (EXT): GrowthBond, ClampGrowth G-012 underflow guard, secondary market
All packages >=93.3% coverage. Both lexicon firewalls green. G-003 intact.

(B) Documentation deliverable (REQ-027 complete, 26-page MkDocs Material site):
- README.md + mkdocs.yml + docs/index.md
- docs/shared/ (7 pages): Six Principles, Bread Scale, Storage Pools, Watchers/Mirror, Lexicon, Vision
- docs/nomads/ (8 pages): Reach, Stash, Bearers, Maps-Pay, Pacts, Standing, Window
- docs/freeholders/ (8 pages): Signals, Standing, Stands-Guilds, Councils-Voice, Bonds, Partner Spectrum, Anchor Preview
- docs/reference/ (2 pages): Architecture, Components
- REQ-028: lexicon firewall extended to docs/ + README.md (lexicon_meta_docs_test.go, 5 tests incl G-013 walk-coverage + G-014 shared self-test)

Phases: P0 -> v0.2.0, P1 -> v0.2.1, P2 -> v0.2.2, P3 -> v0.2.3, P4 -> v0.2.4, P5 -> v0.2.5, P6 -> v0.2.6 (milestone release).

Requirements covered: REQ-010, REQ-022, REQ-023, REQ-024, REQ-025, REQ-026 (skeleton), REQ-027, REQ-028 (complete).
IDEATE-01..08 ratified and delivered.

---ci---
project: oy
phase: 6
milestone: v0.3
status: complete
tag_base: v0.2.x
phase_role: final
milestone_complete: true
requirements:
  covered: [REQ-010, REQ-022, REQ-023, REQ-024, REQ-025, REQ-026, REQ-027, REQ-028]
  partial: []
---/ci---
2026-08-17 22:35:36 +00:00

63 lines
2.3 KiB
YAML

# OpenYield docs site (MkDocs Material, D-042).
#
# Build-only Python dep (mkdocs + mkdocs-material); NOT a Go dep (G-006 —
# go.mod stays zero-require). Invoke locally with `mkdocs serve` or
# `mkdocs build` (see README). No publishing CI in v0.3 (D-046 — publishing
# to GitHub/Gitea Pages deferred to v0.4).
#
# Nav completeness (G-011): the nav lists ALL 26 pages that will exist by end
# of P3. P1 creates the shared/ pages + index (8 files); P2 adds nomads/
# (8 files); P3 adds freeholders/ (8 files) + reference/ (2 files). Only the
# files that exist at P1 ship today; the nav references the not-yet-created
# P2/P3 pages by path so the structure is complete and P2/P3 just add files.
# mkdocs.yml is a config file, NOT validated by Go tests; the docs firewall
# (lexicon_meta_docs_test.go) validates .md content, not nav.
site_name: OpenYield
site_description: OpenYield — a jurisdiction-light, public-good mesh for real production, organized around Holders, Stands, and the Six Principles.
theme:
name: material
features:
- navigation.sections
- navigation.expand
- toc.integrate
markdown_extensions:
- admonition
- toc:
permalink: true
- codehilite
- pymdownx.superfences
nav:
- Home: index.md
- Nomads:
- Overview: nomads/index.md
- Reach: nomads/reach.md
- Stash: nomads/stash.md
- Bearers: nomads/bearers.md
- Maps-Pay: nomads/maps-pay.md
- Pacts: nomads/pacts.md
- Standing: nomads/standing.md
- Window: nomads/window.md
- Freeholders:
- Overview: freeholders/index.md
- Signals: freeholders/signals.md
- Standing: freeholders/standing.md
- Stands & Guilds: freeholders/stands-guilds.md
- Councils & Voice: freeholders/councils-voice.md
- Bonds: freeholders/bonds.md
- Partner Spectrum: freeholders/partner-spectrum.md
- Anchor Preview: freeholders/anchor-preview.md
- Shared:
- Overview: shared/index.md
- Six Principles: shared/six-principles.md
- Bread Scale: shared/bread-scale.md
- Storage Pools: shared/storage-pools.md
- Watchers & Mirror: shared/watchers-mirror.md
- Lexicon: shared/lexicon.md
- Vision: shared/vision.md
- Reference:
- Architecture: reference/architecture.md
- Components: reference/components.md