rust-lang / rust-lang/rfcs

Semantically version the language specification, compiler, and libraries

Open
#303 1 comment 2 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

A-stability A-versioning T-core
Dominant language
Markdown
Stars
6.6k
Forks
1.7k
Avg merge
16h 14m
Merged PRs (30d)
1

Description

Issue by cmr
Wednesday Jan 08, 2014 at 04:57 GMT

For earlier discussion, see https://github.com/rust-lang/rust/issues/11396

This issue was labelled with: A-versioning, B-RFC in the Rust repository


semver is a specification for version numbers and what they mean. Once we hit 1.0, I think we should start semver for everything, thus actually making it 1.0.0.

The "public API" we define would only consist of items marked #[stable] in the libraries. For the language, it would be anything not requiring a feature gate. For the compiler, it'd be output filenames and arguments, excluding -Z, --link-args, --linker, undefined lints, --lvm-args, --passes, and --ar.

Nominating.

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by reading the earlier discussion in Rust issue #11396 and the semver specification linked in this issue. Define the proposed versioning policy for the language specification, compiler, and libraries, including the stated public API boundaries; done means the policy is agreed and documented as an RFC.

Written by the indexing model from the issue text.

Assessment

Tech stack
rust
Domain
compilers
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.