diff options
author | Alex Eagle <alex@aspect.dev> | 2023-09-26 08:42:28 -0700 |
---|---|---|
committer | GitHub <noreply@github.com> | 2023-09-26 08:42:28 -0700 |
commit | 3a8b1ceb68dd0fa8280f185b6edc5e8c10a129ca (patch) | |
tree | feb6a3ad1ec3b8dac8978382f8d2898f66ee4040 | |
parent | 673e59ea247296c95c51ac01de67f4de8f7a846a (diff) | |
download | bazelbuild-rules-proto-3a8b1ceb68dd0fa8280f185b6edc5e8c10a129ca.tar.gz |
docs: explain the roadmap
Closes #176
-rw-r--r-- | README.md | 14 |
1 files changed, 12 insertions, 2 deletions
@@ -2,7 +2,8 @@ * Postsubmit [![Build status](https://badge.buildkite.com/26d40f574d6f6026928bc271780782e5f168fe7e3595ea6d79.svg?branch=master)](https://buildkite.com/bazel/rules-proto) -This repository contains Starlark implementation of Protobuf rules in Bazel. +This repository contains a Starlark implementation of `proto_library` and related "base layer" rules in Bazel. +It does **not** provide rules for any specific languages. These are typically expected to be provided in the ruleset for the language. For a high-level overview of using Protocol Buffers and gRPC with Bazel, see <https://bazel-contrib.github.io/SIG-rules-authors/proto-grpc.html>. @@ -10,6 +11,15 @@ For a high-level overview of using Protocol Buffers and gRPC with Bazel, see For the list of Proto rules, see the Bazel [documentation](https://docs.bazel.build/versions/master/be/overview.html). +## Roadmap + +As of September 2023, this repo is mostly empty and contains stubs for `proto_library`, `ProtoInfo` and other proto toolchain support rules. + +This will change soon, around the time Bazel 7 is released (in Oct/Nov 2023), because the stubs will be replaced with actual implementations. +We plan to remove the native implementations in Bazel 8, at which point rules_proto will be the only way to build Protobuf rules. + +As such it's recommended to use this repository now, so that the removal of implementations from Bazel 8 does not cause you problems. + ## Getting Started To get started with `rules_proto`, add the `WORKSPACE` file snippet from the @@ -46,4 +56,4 @@ feature requests only. For asking questions see: * [rules_proto mailing list](https://groups.google.com/forum/#!forum/proto-bazel-discuss) -* Slack channel `#proto` on [slack.bazel.build](https://slack.bazel.build)
\ No newline at end of file +* Slack channel `#proto` on [slack.bazel.build](https://slack.bazel.build) |