diff options
author | Yifan Hong <elsk@google.com> | 2024-01-16 16:42:56 -0800 |
---|---|---|
committer | Yifan Hong <elsk@google.com> | 2024-01-16 16:42:57 -0800 |
commit | 1508c18d9e27325a8d9c574a90d205e0a1d8a78f (patch) | |
tree | 721d3225371f656a66228a41796c81aa4d8bc096 /docs/sphinx/support.md | |
parent | 3e21f23d9400ba51f10e9b76016ff6d472829b4e (diff) | |
parent | 231d3f633fbcbb36028d96a188298df99bf153e1 (diff) | |
download | bazelbuild-rules_python-1508c18d9e27325a8d9c574a90d205e0a1d8a78f.tar.gz |
Upgrade bazelbuild-rules_python to 0.28.0
This project was upgraded with external_updater.
Usage: tools/external_updater/updater.sh update bazelbuild-rules_python
For more info, check https://cs.android.com/android/platform/superproject/+/main:tools/external_updater/README.md
Test: TreeHugger
Change-Id: Ic0584645f577a4ea1f67458ca5e753f8a906aaa4
Diffstat (limited to 'docs/sphinx/support.md')
-rw-r--r-- | docs/sphinx/support.md | 61 |
1 files changed, 61 insertions, 0 deletions
diff --git a/docs/sphinx/support.md b/docs/sphinx/support.md new file mode 100644 index 0000000..a2b8e3a --- /dev/null +++ b/docs/sphinx/support.md @@ -0,0 +1,61 @@ +# Support Policy + +The Bazel community maintains this repository. Neither Google nor the Bazel team +provides support for the code. However, this repository is part of the test +suite used to vet new Bazel releases. See the <project:#contributing> +page for information on our development workflow. + +## Supported rules_python Versions + +In general, only the latest version is supported. Backporting changes is +done on a best effort basis based on severity, risk of regressions, and +the willingness of volunteers. + +If you want or need particular functionality backported, then the best way +is to open a PR to demonstrate the feasibility of the backport. + +## Supported Bazel Versions + +The supported Bazel versions are: + +1. The latest rolling release +2. The active major release. +3. The major release prior to the active release. + +For (2) and (3) above, only the latest minor/patch version of the major release +is officially supported. Earlier minor/patch versions are supported on a +best-effort basis only. We increase the minimum minor/patch version as necessary +to fix bugs or introduce functionality relying on features introduced in later +minor/patch versions. + +See [Bazel's release support matrix](https://bazel.build/release#support-matrix) +for what versions are the rolling, active, and prior releases. + +## Supported Platforms + +We only support the platforms that our continuous integration jobs run, which +is Linux, Mac, and Windows. Code to support other platforms is allowed, but +can only be on a best-effort basis. + +## Compatibility Policy + +We generally follow the [Bazel Rule +Compatibility](https://bazel.build/release/rule-compatibility) guidelines, which +provides a path from an arbitrary release to the latest release in an +incremental fashion. + +Breaking changes are allowed, but follow a process to introduce them over +a series of releases to so users can still incrementally upgrade. See the +[Breaking Changes](contributing#breaking-changes) doc for the process. + +## Experimental Features + +An experimental features is functionality that may not be ready for general +use and may change quickly and/or significantly. Such features are denoted in +their name or API docs as "experimental". They may have breaking changes made at +any time. + +If you like or use an experimental feature, then file issues to request it be +taken out of experimental. Often times these features are experimental because +we need feedback or experience to verify they are working, useful, and worth the +effort of supporting. |