slovo/CONTRIBUTING.md
2026-05-22 08:43:06 +02:00

1.0 KiB

Contributing

Slovo is currently in 1.0.0-beta. Changes should preserve the beta support boundary: a feature is supported only when the language docs, compiler, formatter, diagnostics, examples, tests, and release notes agree.

Local Checks

From the repository root:

cargo fmt --manifest-path compiler/Cargo.toml --check
cargo test --manifest-path compiler/Cargo.toml
./scripts/release-gate.sh

Publication PDFs are committed artifacts. Regenerate them explicitly with ./scripts/render-doc-pdfs.sh before a documentation release, then run the release gate to verify the repository without mutating tracked files.

Standard Library

Source-authored standard-library modules live in lib/std. Keep imports explicit and keep compiler/runtime support aligned with the promoted language contract.

Release Discipline

  • exp-* labels are historical experimental milestones.
  • 1.0.0-beta is the first real general-purpose beta.
  • 1.0.0 should wait for compatibility hardening, conformance coverage, and stable standard-library policy.