From bea90dfd628b5c6c10f85349bf0b02df226aa7df Mon Sep 17 00:00:00 2001 From: teor Date: Wed, 18 Oct 2023 07:54:01 +1000 Subject: [PATCH] change(doc): Add instructions for new placeholder crates (#7751) * Add instructions for new placeholder crates * minor changes --------- Co-authored-by: Alfredo Garcia --- book/src/dev/crate-owners.md | 18 +++++++++++++++++- 1 file changed, 17 insertions(+), 1 deletion(-) diff --git a/book/src/dev/crate-owners.md b/book/src/dev/crate-owners.md index 88a3460a..0c0b91af 100644 --- a/book/src/dev/crate-owners.md +++ b/book/src/dev/crate-owners.md @@ -35,7 +35,23 @@ please paste the token found on https://crates.io/me below Login token for `crates.io` saved ``` -## Crate Ownership +## Publishing New Crates + +We publish a new placeholder crate as soon as we have a good idea for a crate name. + +Before starting with the publishing, please clone zebra and use the `main` branch to create the placeholder crate, you need `cargo release` installed in the system and be logged to crates.io with `cargo login`. + +Next, execute the following commands to publish a new placeholder and set the owners: +```sh +cargo new new-crate-name +cd new-crate-name +cargo release publish --verbose --package new-crate-name --execute +cargo owner --add oxarbitrage +cargo owner --add teor2345 +cargo owner --add github:zcashfoundation:owners +``` + +## Changing Crate Ownership crates.io has two kinds of owners: group owners and individual owners. All owners can publish and yank crates. But [only individual owners can change crate owners](https://doc.rust-lang.org/cargo/reference/publishing.html#cargo-owner).