Skip to content

Commit 8a315cb

Browse files
crates-io: move crate removal procedure (#297)
Co-authored-by: XAMPPRocky <[email protected]>
1 parent 3bb867e commit 8a315cb

File tree

3 files changed

+53
-0
lines changed

3 files changed

+53
-0
lines changed

src/SUMMARY.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -17,6 +17,8 @@
1717
- [Submitting a proposal](./compiler/steering-meeting/submit.md)
1818
- [How to run the planning meeting](./compiler/steering-meeting/how-to-run-planning.md)
1919
- [How to run a design meeting](./compiler/steering-meeting/how-to-run-design.md)
20+
- [crates.io](./crates-io/README.md)
21+
- [Crate removal](./crates-io/crate-removal.md)
2022
- [GitHub](./github.md)
2123
- [Governance](./governance/README.md)
2224
- [Infrastructure](./infra/README.md)

src/crates-io/README.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
# crates.io
2+
3+
This section documents the processes of the crates.io team.

src/crates-io/crate-removal.md

Lines changed: 48 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,48 @@
1+
# Crate removal procedure
2+
3+
> **Status 2020-01-21**: this document is incomplete and unvetted. We anticipate to
4+
> be receiving guidelines from Mozilla Legal in the near future. If this notice
5+
> is still here on 2020-03-21, please comment on [this issue][outdated-issue]
6+
> asking for a status update.
7+
8+
[outdated-issue]: https://github.com/rust-lang/crates-io-cargo-teams/issues/63
9+
10+
If we get a DMCA takedown notice, here's what needs to happen:
11+
12+
## Remove relevant version(s) and/or entire crates from crates.io
13+
14+
* Remove it from the database:
15+
16+
heroku run -- cargo run --bin delete-crate [crate-name]
17+
18+
or
19+
20+
heroku run -- cargo run --bin delete-version [crate-name] [version-number]
21+
22+
* Remove the crate or version from the index. To remove an entire crate, remove
23+
the entire crate file. For a version, remove the line corresponding to the
24+
relevant version.
25+
26+
* Remove the crate archive(s) and readme file(s) from S3.
27+
28+
* Invalidate the CloudFront cache – remove both the relevant readme and crate
29+
files. If in doubt, invalidate `/*` to flush everything.
30+
31+
## Remove entire crates from docs.rs
32+
33+
The docs.rs application supports deleting all the documentation ever published
34+
of a crate, by running a CLI command. The people who currently have permissions
35+
to access the server and run it are:
36+
37+
* docs.rs Team:
38+
* [@QuietMisdreavus](https://github.com/QuietMisdreavus)
39+
* [@pietroalbini](https://github.com/pietroalbini)
40+
* [@onur](https://github.com/onur)
41+
* [@jyn514](https://github.com/jyn514)
42+
* Infrastructure Team:
43+
* [@Mark-Simulacrum](https://github.com/Mark-Simulacrum)
44+
* People with elevated 1password access
45+
46+
You can find the documentation on how to run the command [here][docsrs-howto].
47+
48+
[docsrs-howto]: https://forge.rust-lang.org/infra/docs/docs-rs.html#removing-a-crate-from-the-website

0 commit comments

Comments
 (0)