From 0bba01661c01ca540625f63a0d7e89d43e2dab34 Mon Sep 17 00:00:00 2001
From: Yoshi Automation Bot <yoshi-automation@google.com>
Date: Thu, 15 Jul 2021 07:48:09 -0700
Subject: [PATCH] chore: regenerate README (#743)

This PR was generated using Autosynth. :rainbow:


<details><summary>Log from Synthtool</summary>

```
2021-07-15 14:34:59,195 synthtool [DEBUG] > Executing /root/.cache/synthtool/java-pubsub/.github/readme/synth.py.
On branch autosynth-readme
nothing to commit, working tree clean
2021-07-15 14:35:00,553 synthtool [DEBUG] > Wrote metadata to .github/readme/synth.metadata/synth.metadata.

```
</details>

Full log will be available here:
https://source.cloud.google.com/results/invocations/839f4eb4-03b8-41ac-9fc6-07ce34da1039/targets

- [ ] To automatically regenerate this PR, check this box. (May take up to 24 hours.)
---
 .github/readme/synth.metadata/synth.metadata |  4 +-
 README.md                                    | 48 +++++++++++++++++++-
 2 files changed, 49 insertions(+), 3 deletions(-)

diff --git a/.github/readme/synth.metadata/synth.metadata b/.github/readme/synth.metadata/synth.metadata
index 36cfbe817..296c41c8c 100644
--- a/.github/readme/synth.metadata/synth.metadata
+++ b/.github/readme/synth.metadata/synth.metadata
@@ -4,14 +4,14 @@
       "git": {
         "name": ".",
         "remote": "https://github.com/googleapis/java-pubsub.git",
-        "sha": "3c1570eaa2a5625c5706de07c83c7b53b0dbc14b"
+        "sha": "1add5e272ee1c0df9af0956ca240447e3b190a30"
       }
     },
     {
       "git": {
         "name": "synthtool",
         "remote": "https://github.com/googleapis/synthtool.git",
-        "sha": "09c59c20a4bf0daed1665af59035ff240fe356df"
+        "sha": "4124d245133c0f740ac5e6fa2e7daeba327f1297"
       }
     }
   ]
diff --git a/README.md b/README.md
index f6304f9d0..0cddf7491 100644
--- a/README.md
+++ b/README.md
@@ -287,10 +287,50 @@ has instructions for running the samples.
 
 To get help, follow the instructions in the [shared Troubleshooting document][troubleshooting].
 
-## 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
 
 
@@ -351,3 +391,9 @@ Java is a registered trademark of Oracle and/or its affiliates.
 [enable-api]: https://console.cloud.google.com/flows/enableapi?apiid=pubsub.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