# 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:

```bash
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.
