Skip to content

chore: Improve stability levels section in README #16851

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
parthea merged 1 commit into from
Apr 28, 2026
+19 −23
Merged

chore: Improve stability levels section in README #16851

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
42 changes: 19 additions & 23 deletions README.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,42 +14,38 @@ of a package.

.. _development status classifier: https://pypi.org/classifiers/

General Availability
--------------------
Stable
------

**GA** (general availability) indicates that the client library for a
particular service is stable, and that the code surface will not change in
**Stable** (general availability) indicates that the client library for a
particular service is GA, and that the code surface will not change in
backwards-incompatible ways unless either absolutely necessary (e.g. because
of critical security issues) or with an extensive deprecation period.
Issues and requests against GA libraries are addressed with the highest
Issues and requests against stable libraries are addressed with the highest
priority.

GA libraries have development status classifier ``Development Status :: 5 - Production/Stable``.
Stable libraries have development status classifier ``Development Status :: 5 - Production/Stable``.

.. note::

Sub-components of GA libraries explicitly marked as beta in the
Sub-components of stable libraries explicitly marked as beta in the
import path (e.g. ``google.cloud.language_v1beta2``) should be considered
to be beta.
to be preview.

Beta Support
------------
Preview
-------

**Beta** indicates that the client library for a particular service is
mostly stable and is being prepared for release. Issues and requests
against beta libraries are addressed with a higher priority.
**Preview** indicates that the client library for a particular service is
under development—either in **Beta** or **Alpha**—and is being prepared for
release.

Beta libraries have development status classifier ``Development Status :: 4 - Beta``.
* **Beta** indicates the library is mostly stable. Issues and requests
against beta libraries are addressed with a higher priority.
(``Development Status :: 4 - Beta``)
* **Alpha** indicates the library is still a work-in-progress and is more
likely to get backwards-incompatible updates. (``Development Status :: 3 - Alpha``)
Comment on lines +38 to +46
Copy link
Copy Markdown
Contributor

@gemini-code-assist gemini-code-assist Bot Apr 28, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

This section contains several trailing whitespaces (lines 39, 40, 42, 43, and 45). Additionally, the formatting for the Alpha and Beta descriptions is inconsistent; the Beta classifier is on a new line while the Alpha one is inline. Consolidating the layout improves readability and consistency.

Suggested change
**Preview** indicates that the client library for a particular service is
under development—either in **Beta** or **Alpha**—and is being prepared for
release.
Beta libraries have development status classifier ``Development Status :: 4 - Beta``.
* **Beta** indicates the library is mostly stable. Issues and requests
against beta libraries are addressed with a higher priority.
(``Development Status :: 4 - Beta``)
* **Alpha** indicates the library is still a work-in-progress and is more
likely to get backwards-incompatible updates. (``Development Status :: 3 - Alpha``)
**Preview** indicates that the client library for a particular service is
under development—either in **Beta** or **Alpha**—and is being prepared for
release.
* **Beta** indicates the library is mostly stable. Issues and requests
against beta libraries are addressed with a higher priority.
(Development Status :: 4 - Beta)
* **Alpha** indicates the library is still a work-in-progress and is more
likely to get backwards-incompatible updates.
(Development Status :: 3 - Alpha)


Alpha Support
-------------

**Alpha** indicates that the client library for a particular service is
still a work-in-progress and is more likely to get backwards-incompatible
updates. See `versioning`_ for more details.


Alpha libraries have development status classifier ``Development Status :: 3 - Alpha``.
See `versioning`_ for more details.

If you need support for other Google APIs, check out the
`Google APIs Python Client library`_.
Expand Down
Loading