grpc: add readme and tidy up Cargo.tomls

grpc-protobuf-build/Cargo.toml

@@ -1,11 +1,16 @@
 [package]
 name = "grpc-protobuf-build"
 version = "0.9.0-alpha.1"
-edition = "2024"
 authors = ["gRPC Authors"]
 license = "MIT"
-publish = false
+homepage = "https://grpc.io"
+repository = "https://github.com/grpc/grpc-rust"
+description = "Protobuf build integration for grpc"
+readme = "README.md"
+keywords = ["rpc", "grpc", "async", "protobuf", "proto"]
+categories = ["web-programming", "network-programming", "asynchronous"]
 rust-version = { workspace = true }
+edition = "2024"
 
 [dependencies]
 prettyplease = "0.2.35"

grpc-protobuf/Cargo.toml

@@ -1,11 +1,15 @@
 [package]
 name = "grpc-protobuf"
 version = "0.9.0-alpha.1"
-edition = "2024"
 authors = ["gRPC Authors"]
 license = "MIT"
+homepage = "https://grpc.io"
+repository = "https://github.com/grpc/grpc-rust"
+description = "Protobuf integration for the grpc crate"
+keywords = ["rpc", "grpc", "async", "protobuf", "proto"]
+categories = ["web-programming", "network-programming", "asynchronous"]
 rust-version = { workspace = true }
-publish = false
+edition = "2024"
 
 [package.metadata.cargo_check_external_types]
 allowed_external_types = [
@@ -17,7 +21,7 @@ allowed_external_types = [
 
 [dependencies]
 bytes = "1.11.1"
-grpc = { path = "../grpc" }
+grpc = { version = "0.9.0-alpha.1", path = "../grpc" }
 protobuf = "4.34.0-release"
 
 [dev-dependencies]

grpc/Cargo.toml

@@ -1,11 +1,17 @@
 [package]
 name = "grpc"
 version = "0.9.0-alpha.1"
-edition = "2024"
 authors = ["gRPC Authors"]
 license = "MIT"
+homepage = "https://grpc.io"
+repository = "https://github.com/grpc/grpc-rust"
+description = """
+The official Rust implementation of gRPC: a high performance, open source, universal RPC framework.
+"""
+keywords = ["rpc", "grpc", "async", "protobuf", "proto"]
+categories = ["web-programming", "network-programming", "asynchronous"]
 rust-version = { workspace = true }
-publish = false
+edition = "2024"
 
 [package.metadata.cargo_check_external_types]
 allowed_external_types = [

grpc/README.md

@@ -0,0 +1,41 @@
+# gRPC-Rust
+
+The official Rust implementation of [gRPC], a high performance, open source,
+universal RPC framework.
+
+> NOTE: This version is a preview and not recommended for any production
+> use.  All APIs are unstable.  Proceed at your own risk.
+
+## Documentation, Examples, and Getting Started
+
+Please see [our website] for everything you should need to get started using
+gRPC!
+
+[our website]: https://grpc.io/docs/languages/rust
+
+### Rust Version
+
+`grpc`'s MSRV is `1.88`.
+
+### Project Layout
+
+- `grpc` (this crate): The core gRPC implementation.
+- [`protoc-gen-rust-grpc`]: The protobuf code generator binary, used with [`protoc`].
+- [`grpc-protobuf-build`]: Build integration for grpc protobuf code generation.
+- [`grpc-protobuf`]: Implementation of protobuf-over-grpc used by the generated code.
+
+## License
+
+This project is licensed under the [MIT license](../LICENSE) and/or the [`Apache
+license 2.0`](https://www.apache.org/licenses/LICENSE-2.0.txt).
+
+### Contributing
+
+If you'd like to contribute, please see our project's
+[`CONTRIBUTING.md`](../CONTRIBUTING.md) for some guidelines.
+
+[gRPC]: https://grpc.io
+[`protoc`]: https://protobuf.dev/installation/
+[`protoc-gen-rust-grpc`]: ../protoc-gen-rust-grpc
+[`grpc-protobuf-build`]: ../grpc-protobuf-build
+[`grpc-protobuf`]: ../grpc-protobuf