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