Some checks are pending
Docs CI / lint-and-preview (push) Waiting to run
- Introduced guild charters for Scanner Deno, PHP, Ruby, Native, WebService, Java, Surface.Env, Surface.FS, Surface.Secrets, Surface.Validation, UI, Zastava Observer, Zastava Webhook, Zastava Core, and Plugin Platform. - Each charter outlines the mission, scope, required reading, and working agreements for the respective guilds. - Created task boards for Surface.Env, Surface.FS, Surface.Secrets, Surface.Validation, and Zastava components to track progress and dependencies. - Ensured all documents emphasize determinism, offline readiness, security, and integration with shared Surface libraries.
2.0 KiB
2.0 KiB
Docs & Enablement Guild
Mission
Produce and maintain offline-friendly documentation for StellaOps modules, covering architecture, configuration, operator workflows, and developer onboarding.
Scope Highlights
- Authority docs (
docs/dev/31_AUTHORITY_PLUGIN_DEVELOPER_GUIDE.md, upcomingdocs/11_AUTHORITY.md). - Concelier quickstarts, CLI guides, Offline Kit manuals.
- Release notes and migration playbooks.
Operating Principles
- Keep guides deterministic and in sync with shipped configuration samples.
- Prefer tables/checklists for operator steps; flag security-sensitive actions.
- When work involves a specific
StellaOps.<Component>project, consult bothdocs/07_HIGH_LEVEL_ARCHITECTURE.mdand the matching dossierdocs/modules/<component>/architecture.mdbefore drafting or editing content. - Update
docs/TASKS.mdwhenever work items change status (TODO/DOING/REVIEW/DONE/BLOCKED).
Coordination
- Authority Core & Plugin teams for auth-related changes.
- Security Guild for threat-model outputs and mitigations.
- DevEx for tooling diagrams and documentation pipeline.
Required Reading
docs/README.mddocs/07_HIGH_LEVEL_ARCHITECTURE.mddocs/modules/platform/architecture-overview.mddocs/dev/31_AUTHORITY_PLUGIN_DEVELOPER_GUIDE.md- Module-specific README and architecture dossiers for the area you are updating (for example,
docs/modules/concelier/README.mdanddocs/modules/concelier/architecture.md)
Working Agreement
-
- Update task status to
DOING/DONEin bothdocs/implplan/SPRINTS.mdand the localTASKS.mdwhen you start or finish work.
- Update task status to
-
- Review this charter and the Required Reading documents before coding; confirm prerequisites are met.
-
- Keep changes deterministic (stable ordering, timestamps, hashes) and align with offline/air-gap expectations.
-
- Coordinate doc updates, tests, and cross-guild communication whenever contracts or workflows change.
-
- Revert to
TODOif you pause the task without shipping changes; leave notes in commit/PR descriptions for context.
- Revert to