Skip to content
This repository was archived by the owner on Nov 9, 2023. It is now read-only.

Commit f985381

Browse files
chore: regenerate README (#545)
This PR was generated using Autosynth. 🌈 <details><summary>Log from Synthtool</summary> ``` 2021-07-14 17:08:26,041 synthtool [DEBUG] > Executing /root/.cache/synthtool/java-document-ai/.github/readme/synth.py. On branch autosynth-readme nothing to commit, working tree clean 2021-07-14 17:08:27,386 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/59e964af-fa0a-4e75-8ec5-9e73ba711411/targets - [ ] To automatically regenerate this PR, check this box. (May take up to 24 hours.)
1 parent 9fe6315 commit f985381

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-document-ai.git",
7-
"sha": "ef21c28798d67b3d17b732dfa902b9eb59c0c0e8"
7+
"sha": "9fe63150ad0e6ef800a9fef26d8029011663cad7"
88
}
99
},
1010
{
1111
"git": {
1212
"name": "synthtool",
1313
"remote": "https://github.com/googleapis/synthtool.git",
14-
"sha": "09c59c20a4bf0daed1665af59035ff240fe356df"
14+
"sha": "e44dc0c742b1230887a73552357e0c18dcc30b92"
1515
}
1616
}
1717
]

README.md

Lines changed: 47 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -119,10 +119,50 @@ To get help, follow the instructions in the [shared Troubleshooting document][tr
119119

120120
Document AI uses gRPC for the transport layer.
121121

122-
## Java Versions
122+
## Supported Java Versions
123123

124124
Java 7 or above is required for using this client.
125125

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

128168

@@ -183,3 +223,9 @@ Java is a registered trademark of Oracle and/or its affiliates.
183223
[enable-api]: https://console.cloud.google.com/flows/enableapi?apiid=documentai.googleapis.com
184224
[libraries-bom]: https://github.com/GoogleCloudPlatform/cloud-opensource-java/wiki/The-Google-Cloud-Platform-Libraries-BOM
185225
[shell_img]: https://gstatic.com/cloudssh/images/open-btn.png
226+
227+
[semver]: https://semver.org/
228+
[cloudlibs]: https://cloud.google.com/apis/docs/client-libraries-explained
229+
[apilibs]: https://cloud.google.com/apis/docs/client-libraries-explained#google_api_client_libraries
230+
[oracle]: https://www.oracle.com/java/technologies/java-se-support-roadmap.html
231+
[g-c-j]: http://github.com/googleapis/google-cloud-java

0 commit comments

Comments
 (0)