From e6b449dd660b91e60a68387912c83b1396682bff Mon Sep 17 00:00:00 2001 From: Yoshi Automation Bot Date: Wed, 14 Jul 2021 09:48:20 -0700 Subject: [PATCH] chore: regenerate README (#548) This PR was generated using Autosynth. :rainbow:
Log from Synthtool ``` 2021-07-14 16:42:18,492 synthtool [DEBUG] > Executing /root/.cache/synthtool/java-resourcemanager/.github/readme/synth.py. On branch autosynth-readme nothing to commit, working tree clean 2021-07-14 16:42:19,731 synthtool [DEBUG] > Wrote metadata to .github/readme/synth.metadata/synth.metadata. ```
Full log will be available here: https://source.cloud.google.com/results/invocations/7ae0af25-3d7f-4e10-b9dd-d33132f3652d/targets - [ ] To automatically regenerate this PR, check this box. (May take up to 24 hours.) --- .../readme/synth.metadata/synth.metadata | 4 +- java-resourcemanager/README.md | 48 ++++++++++++++++++- 2 files changed, 49 insertions(+), 3 deletions(-) diff --git a/java-resourcemanager/.github/readme/synth.metadata/synth.metadata b/java-resourcemanager/.github/readme/synth.metadata/synth.metadata index b48856d6a4f1..57cc38a8dc13 100644 --- a/java-resourcemanager/.github/readme/synth.metadata/synth.metadata +++ b/java-resourcemanager/.github/readme/synth.metadata/synth.metadata @@ -4,14 +4,14 @@ "git": { "name": ".", "remote": "https://github.com/googleapis/java-resourcemanager.git", - "sha": "619022909b0ee49d03d605841c4e479376de0b89" + "sha": "1139153f5928009a6dfc5a41a6a7fa3689936690" } }, { "git": { "name": "synthtool", "remote": "https://github.com/googleapis/synthtool.git", - "sha": "1620b2cbb253f05f9e97be5efc371d2ba3844179" + "sha": "e44dc0c742b1230887a73552357e0c18dcc30b92" } } ] diff --git a/java-resourcemanager/README.md b/java-resourcemanager/README.md index c1d3114d17fe..7154ad63264f 100644 --- a/java-resourcemanager/README.md +++ b/java-resourcemanager/README.md @@ -243,10 +243,50 @@ To get help, follow the instructions in the [shared Troubleshooting document][tr Resource Manager API uses HTTP/JSON for the transport layer. -## Java Versions +## Supported Java Versions Java 7 or above is required for using this client. +Google's Java client libraries, +[Google Cloud Client Libraries][cloudlibs] +and +[Google Cloud API Libraries][apilibs], +follow the +[Oracle Java SE support roadmap][oracle] +(see the Oracle Java SE Product Releases section). + +### For new development + +In general, new feature development occurs with support for the lowest Java +LTS version covered by Oracle's Premier Support (which typically lasts 5 years +from initial General Availability). If the minimum required JVM for a given +library is changed, it is accompanied by a [semver][semver] major release. + +Java 11 and (in September 2021) Java 17 are the best choices for new +development. + +### Keeping production systems current + +Google tests its client libraries with all current LTS versions covered by +Oracle's Extended Support (which typically lasts 8 years from initial +General Availability). + +#### Legacy support + +Google's client libraries support legacy versions of Java runtimes with long +term stable libraries that don't receive feature updates on a best efforts basis +as it may not be possible to backport all patches. + +Google provides updates on a best efforts basis to apps that continue to use +Java 7, though apps might need to upgrade to current versions of the library +that supports their JVM. + +#### Where to find specific information + +The latest versions and the supported Java versions are identified on +the individual GitHub repository `github.com/GoogleAPIs/java-SERVICENAME` +and on [google-cloud-java][g-c-j]. + ## Versioning @@ -310,3 +350,9 @@ Java is a registered trademark of Oracle and/or its affiliates. [enable-api]: https://console.cloud.google.com/flows/enableapi?apiid=cloudresourcemanager.googleapis.com [libraries-bom]: https://github.com/GoogleCloudPlatform/cloud-opensource-java/wiki/The-Google-Cloud-Platform-Libraries-BOM [shell_img]: https://gstatic.com/cloudssh/images/open-btn.png + +[semver]: https://semver.org/ +[cloudlibs]: https://cloud.google.com/apis/docs/client-libraries-explained +[apilibs]: https://cloud.google.com/apis/docs/client-libraries-explained#google_api_client_libraries +[oracle]: https://www.oracle.com/java/technologies/java-se-support-roadmap.html +[g-c-j]: http://github.com/googleapis/google-cloud-java