Governance
Cratis is an open-source project, but not every decision belongs in the same channel. Small fixes can move directly through issues and pull requests. Larger design choices need discussion, context, and a durable record.
Share a suggestion Use the feedback page for product ideas, rough edges, documentation gaps, and feature suggestions.
Join the community Use Discord for early discussion and questions that need context.
Contribute Read the contribution workflow, code standards, and project values.
Decision path
Section titled “Decision path”| Change | Path |
|---|---|
| Small documentation fix | Pull request or documentation issue |
| Reproducible bug | Product issue, then pull request |
| Small feature | Product issue with motivation and expected behavior |
| Cross-product design | Discord discussion, then a durable GitHub issue or design note |
| Breaking change | Design discussion, migration notes, release note, and documentation update |
| Security fix | Private report first, public disclosure only after coordination |
How proposals become work
Section titled “How proposals become work”- Start with the problem, not the implementation.
- Discuss early in Community and help when the shape is unclear.
- Capture actionable work in the repository that owns the behavior.
- Link related docs, examples, issues, and pull requests.
- Update documentation and release notes when behavior changes.
Maintainer judgment
Section titled “Maintainer judgment”Maintainers may ask for narrower scope, more context, tests, documentation, migration guidance, or a different product boundary. The goal is to keep Cratis coherent across Chronicle, Arc, Components, CLI, Fundamentals, tools, and the docs.
Community standards
Section titled “Community standards”The Code of Conduct applies across repositories, Discord, issues, pull requests, and project spaces. Security reports use the private process on Security.