33 lines
1.0 KiB
Markdown
33 lines
1.0 KiB
Markdown
# 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.
|