Contribution Guide

Authoring Rules

• Write tenant-first content under docs/<tenant>/...
• Keep persona-based separation (customer, company, association)
• Include API endpoint references only when implemented in production code
• Include failure mode and recovery guidance for critical flows

Review Rules

• PR review from platform docs owner is mandatory
• Product/operations owner approval is required for flow changes
• Update last_reviewed when making any functional change

Release Rules

• Only publish versioned docs from Git tags matching vX.Y.Z
• Use publish-docs-version.sh wrapper to enforce alias policy
• Keep latest and stable in sync for release tags
• Use next only for prerelease docs