Skip to content

Commit 8f992f8

Browse files
committed
doc: better document supported platform tiers
Fixes bazel-contrib#2722. Related bazel-contrib#2734, bazel-contrib#2276, bazel-contrib#1579
1 parent 8fc25de commit 8f992f8

File tree

1 file changed

+23
-2
lines changed

1 file changed

+23
-2
lines changed

docs/support.md

+23-2
Original file line numberDiff line numberDiff line change
@@ -31,11 +31,32 @@ minor/patch versions.
3131
See [Bazel's release support matrix](https://bazel.build/release#support-matrix)
3232
for what versions are the rolling, active, and prior releases.
3333

34+
## Supported Python versions
35+
36+
As a general rule we test all released non-EOL Python versions. Different
37+
interpreter versions may work but are not guaranteed. We are interested in
38+
staying compatible with upcoming unreleased versions, so if you see that things
39+
stop working, please create tickets or, more preferably, pull requests.
40+
3441
## Supported Platforms
3542

3643
We only support the platforms that our continuous integration jobs run, which
37-
is Linux, Mac, and Windows. Code to support other platforms is allowed, but
38-
can only be on a best-effort basis.
44+
is Linux, Mac, and Windows.
45+
46+
In order to better describe different support levels, the below acts as a rough
47+
guideline for different platform tiers:
48+
* Tier 0 - The platforms that our CI runs: `linux_x86_64`, `osx_x86_64`, `windows_x86_64`, `RBE linux_x86_64`.
49+
* Tier 1 - The platforms that are similar enough to what the CI runs: `linux_aarch64`, `osx_aarch64`.
50+
* Tier 2 - The rest.
51+
52+
:::{note}
53+
Code to support other platforms is allowed, but regressions will be fixed on a
54+
best-effort basis. Feel free to contribute code that fixes `rules_python` on
55+
a Tier 2 platform.
56+
57+
If you would like to provide/sponsor CI setup for a platform that is not Tier 0,
58+
please create a ticket or contact the maintainers on Slack.
59+
:::
3960

4061
## Compatibility Policy
4162

0 commit comments

Comments
 (0)