aboutsummaryrefslogtreecommitdiff
path: root/UPGRADING.md
diff options
context:
space:
mode:
authorAnthonios Partheniou <partheniou@google.com>2021-03-15 12:18:03 -0400
committerGitHub <noreply@github.com>2021-03-15 16:18:03 +0000
commit22807c92ce754ff3d60f240ec5c38de50c5b654b (patch)
tree82f46e5e6f5bd45f00f53b7d5c28de27caee6cfb /UPGRADING.md
parent827853728d2c4efd03c55643aab78ed87352de62 (diff)
downloadgoogle-api-python-client-22807c92ce754ff3d60f240ec5c38de50c5b654b.tar.gz
docs: Update README to promote cloud client libraries (#1252)
Update README to promote [cloud client libraries](https://github.com/googleapis/google-cloud-python) for new code development for the following reasons: - There is a separate client library for each API, so you can choose which client libraries to download. Whereas, `google-api-python-client` is a single client library for all APIs. As a result, the total package size for `google-api-python-client` exceeds 50MB. - There are stricter controls for breaking changes to the underlying APIs as each client library is focused on a specific API. - There are more features in these Cloud Client Libraries as each library is focused on a specific API, and in some cases, the libraries are owned by team who specialized in that API. - Developers will benefit from intellisense. Fixes #1239 🦕
Diffstat (limited to 'UPGRADING.md')
-rw-r--r--UPGRADING.md5
1 files changed, 4 insertions, 1 deletions
diff --git a/UPGRADING.md b/UPGRADING.md
index c3c9171eb..67143a622 100644
--- a/UPGRADING.md
+++ b/UPGRADING.md
@@ -7,7 +7,10 @@ please continue to use version 1.x as we will continue supporting python 2.7+ in
In addition, discovery documents will no longer be retrieved dynamically when
you call `discovery.build()`. The discovery documents will instead be retrieved
-from the client library directly.
+from the client library directly. As a result of caching the discovery
+documents, the size of this package is at least 50 MB larger compared to the
+previous version.
+
For users of public APIs
------------------------