docs: add procedure to remove a crate from docs.rs's queue

README.md

@@ -12,3 +12,8 @@ licenses.
 ## Guidelines
 
 * [Rust Infrastructure hosting for static websites](guidelines/static-websites.md)
+
+## Documentation
+
+* Services hosted by the Infrastructure Team:
+  * [docs.rs](docs/services/docs-rs.md)

docs/services/docs-rs.md

@@ -0,0 +1,35 @@
+# docs.rs
+
+* Source code: [rust-lang/docs.rs][repo]
+* Hosted on: `docsrs.infra.rust-lang.org` (behind the bastion)
+* Maintainers: [onur][onur], [QuietMisdreavus][QuietMisdreavus]
+
+[repo]: https://github.com/rust-lang/docs.rs
+[onur]: https://github.com/onur
+[QuietMisdreavus]: https://github.com/QuietMisdreavus
+
+## Common maintenance procedures
+
+### Temporarily remove a crate from the queue
+
+It might happen that a crate fails to build repeatedly due to a docs.rs bug,
+clogging up the queue and preventing other crates to build. In this case it's
+possible to temporarily remove the crate from the queue until the docs.rs's bug
+is fixed. To do that, log into the machine and open a PostgreSQL shell with:
+
+```
+$ psql
+```
+
+Then you can run this SQL query to remove the crate:
+
+```
+UPDATE queue SET attempt = 100 WHERE name = '<CRATE_NAME>';
+```
+
+To add the crate back in the queue you can run in the PostgreSQL shell this
+query:
+
+```
+UPDATE queue SET attempt = 0 WHERE name = '<CRATE_NAME>';
+```