Skip to content

Commit 7a69530

Browse files
chore: regenerate README (#535)
This PR was generated using Autosynth. 🌈 <details><summary>Log from Synthtool</summary> ``` 2021-07-14 08:46:45,315 synthtool [DEBUG] > Executing /root/.cache/synthtool/java-spanner-jdbc/.github/readme/synth.py. On branch autosynth-readme nothing to commit, working tree clean 2021-07-14 08:46:46,598 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/ae6a79f2-326e-4d4f-ad8d-bf6a5da0ba25/targets - [ ] To automatically regenerate this PR, check this box. (May take up to 24 hours.)
1 parent a4bd82c commit 7a69530

File tree

2 files changed

+49
-3
lines changed

2 files changed

+49
-3
lines changed

.github/readme/synth.metadata/synth.metadata

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,14 +4,14 @@
44
"git": {
55
"name": ".",
66
"remote": "https://github.com/googleapis/java-spanner-jdbc.git",
7-
"sha": "0c3d02f41a4a5c5d3c3100c247a3ea2adc9090ff"
7+
"sha": "a4bd82c8e4ce8b7179b943ac06b049598276f1b4"
88
}
99
},
1010
{
1111
"git": {
1212
"name": "synthtool",
1313
"remote": "https://github.com/googleapis/synthtool.git",
14-
"sha": "39652e3948f455fd0b77535a0145eeec561a3706"
14+
"sha": "959d4f81f2d1397297ebda90212df92aa0ef3a6a"
1515
}
1616
}
1717
]

README.md

Lines changed: 47 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -128,10 +128,50 @@ activate the `shade` profile like this:
128128

129129
To get help, follow the instructions in the [shared Troubleshooting document][troubleshooting].
130130

131-
## Java Versions
131+
## Supported Java Versions
132132

133133
Java 8 or above is required for using this client.
134134

135+
Google's Java client libraries,
136+
[Google Cloud Client Libraries][cloudlibs]
137+
and
138+
[Google Cloud API Libraries][apilibs],
139+
follow the
140+
[Oracle Java SE support roadmap][oracle]
141+
(see the Oracle Java SE Product Releases section).
142+
143+
### For new development
144+
145+
In general, new feature development occurs with support for the lowest Java
146+
LTS version covered by Oracle's Premier Support (which typically lasts 5 years
147+
from initial General Availability). If the minimum required JVM for a given
148+
library is changed, it is accompanied by a [semver][semver] major release.
149+
150+
Java 11 and (in September 2021) Java 17 are the best choices for new
151+
development.
152+
153+
### Keeping production systems current
154+
155+
Google tests its client libraries with all current LTS versions covered by
156+
Oracle's Extended Support (which typically lasts 8 years from initial
157+
General Availability).
158+
159+
#### Legacy support
160+
161+
Google's client libraries support legacy versions of Java runtimes with long
162+
term stable libraries that don't receive feature updates on a best efforts basis
163+
as it may not be possible to backport all patches.
164+
165+
Google provides updates on a best efforts basis to apps that continue to use
166+
Java 7, though apps might need to upgrade to current versions of the library
167+
that supports their JVM.
168+
169+
#### Where to find specific information
170+
171+
The latest versions and the supported Java versions are identified on
172+
the individual GitHub repository `github.com/GoogleAPIs/java-SERVICENAME`
173+
and on [google-cloud-java][g-c-j].
174+
135175
## Versioning
136176

137177

@@ -191,3 +231,9 @@ Java is a registered trademark of Oracle and/or its affiliates.
191231

192232
[libraries-bom]: https://github.com/GoogleCloudPlatform/cloud-opensource-java/wiki/The-Google-Cloud-Platform-Libraries-BOM
193233
[shell_img]: https://gstatic.com/cloudssh/images/open-btn.png
234+
235+
[semver]: https://semver.org/
236+
[cloudlibs]: https://cloud.google.com/apis/docs/client-libraries-explained
237+
[apilibs]: https://cloud.google.com/apis/docs/client-libraries-explained#google_api_client_libraries
238+
[oracle]: https://www.oracle.com/java/technologies/java-se-support-roadmap.html
239+
[g-c-j]: http://github.com/googleapis/google-cloud-java

0 commit comments

Comments
 (0)