Skip to content

Commit 2fa0dbb

Browse files
peter-lyons-kehlshepmaster
authored andcommitted
Explanation about crate version upgrades.
1 parent ab0646d commit 2fa0dbb

File tree

1 file changed

+11
-3
lines changed

1 file changed

+11
-3
lines changed

CRATE_POLICY.md

Lines changed: 11 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -5,8 +5,15 @@ The playground selects a number of root crates to include:
55
- The top 100 crates based on [all time downloads][]
66
- Crates from the [Rust cookbook][]
77

8-
The latest stable version of these crates are available, as well as
9-
whatever dependencies these crates require.
8+
A recent non-[prerelease][] version of these crates are available, as
9+
well as whatever dependencies these crates require.
10+
11+
Please do not open issues or pull requests about adding or updating
12+
crates available in the playground. This list is maintained
13+
semi-automatically and all crates are updated at once to reduce
14+
duplicate work. The update frequency is sporadic, but usually
15+
corresponds to when a new stable version of Rust is released: every
16+
six weeks.
1017

1118
## Why is there a policy?
1219

@@ -17,7 +24,7 @@ project. It would be infeasible to provide every possible crate.
1724
This inclusion policy is used to avoid "playing favorites" for which
1825
crates are available. Hand-picking crates will lead to resentment
1926
about which crates were not included between the playground
20-
maintainers and crate authors or even the broader Rust community.
27+
maintainers and crate authors or even the broader Rust community.
2128
Neither of these outcomes is desired.
2229

2330
## Exclusion policy
@@ -40,6 +47,7 @@ We are open to well-reasoned [alternate algorithms][], but be aware
4047
that any proposal would likely be expected to also provide the
4148
majority of implementation work.
4249

50+
[prerelease]: https://semver.org/#spec-item-9
4351
[all time downloads]: https://crates.io/crates?sort=downloads
4452
[Rust cookbook]: https://rust-lang-nursery.github.io/rust-cookbook/
4553
[alternate algorithms]: https://github.com/rust-lang/rust-playground/issues/101

0 commit comments

Comments
 (0)