From 35d170bc34d3ee6762c3ce0209f39e05c93c603b Mon Sep 17 00:00:00 2001
From: Alan Zimmer <48699787+alzimmermsft@users.noreply.github.com>
Date: Tue, 9 Jul 2024 10:56:06 -0400
Subject: [PATCH] Add link to Azure CA details outlining baseline Java support
 (#40832)

---
 sdk/core/azure-core-amqp-experimental/README.md       | 2 ++
 sdk/core/azure-core-amqp/README.md                    | 2 ++
 sdk/core/azure-core-experimental/README.md            | 2 ++
 sdk/core/azure-core-http-netty/README.md              | 2 ++
 sdk/core/azure-core-http-okhttp/README.md             | 2 ++
 sdk/core/azure-core-http-vertx/README.md              | 2 ++
 sdk/core/azure-core-management/README.md              | 4 ++++
 sdk/core/azure-core-metrics-opentelemetry/README.md   | 2 ++
 sdk/core/azure-core-serializer-avro-apache/README.md  | 2 ++
 sdk/core/azure-core-serializer-avro-jackson/README.md | 3 ++-
 sdk/core/azure-core-serializer-json-gson/README.md    | 2 ++
 sdk/core/azure-core-serializer-json-jackson/README.md | 2 ++
 sdk/core/azure-core-tracing-opentelemetry/README.md   | 2 ++
 sdk/core/azure-core/README.md                         | 3 ++-
 14 files changed, 30 insertions(+), 2 deletions(-)

diff --git a/sdk/core/azure-core-amqp-experimental/README.md b/sdk/core/azure-core-amqp-experimental/README.md
index 42dfb009447ba..c3127833a3d78 100644
--- a/sdk/core/azure-core-amqp-experimental/README.md
+++ b/sdk/core/azure-core-amqp-experimental/README.md
@@ -9,6 +9,7 @@ Azure Core AMQP Experimental contains types that are being evaluated and might e
 ### Prerequisites
 
 - A [Java Development Kit (JDK)][jdk_link], version 8 or later.
+  - Here are details about [Java 8 client compatibility with Azure Certificate Authority][java8_client_compatibility].
 
 ### Include the package
 
@@ -51,5 +52,6 @@ For details on contributing to this repository, see the [contributing guide](htt
 <!-- Links -->
 [logging]: https://github.com/Azure/azure-sdk-for-java/wiki/Logging-with-Azure-SDK
 [jdk_link]: https://docs.microsoft.com/java/azure/jdk/?view=azure-java-stable
+[java8_client_compatibility]: https://learn.microsoft.com/azure/security/fundamentals/azure-ca-details?tabs=root-and-subordinate-cas-list#client-compatibility-for-public-pkis
 
 ![Impressions](https://azure-sdk-impressions.azurewebsites.net/api/impressions/azure-sdk-for-java%2Fsdk%2Fcore%2Fazure-core-amqp-experimental%2FREADME.png)
diff --git a/sdk/core/azure-core-amqp/README.md b/sdk/core/azure-core-amqp/README.md
index 374103cdcafc1..448812e1fd630 100644
--- a/sdk/core/azure-core-amqp/README.md
+++ b/sdk/core/azure-core-amqp/README.md
@@ -8,6 +8,7 @@ own AMQP client library that abstracts from the underlying transport library's i
 ### Prerequisites
 
 - A [Java Development Kit (JDK)][jdk_link], version 8 or later.
+  - Here are details about [Java 8 client compatibility with Azure Certificate Authority][java8_client_compatibility].
 
 ### Include the package
 #### Include the BOM file
@@ -83,5 +84,6 @@ For details on contributing to this repository, see the [contributing guide](htt
 <!-- Links -->
 [logging]: https://github.com/Azure/azure-sdk-for-java/wiki/Logging-with-Azure-SDK
 [jdk_link]: https://docs.microsoft.com/java/azure/jdk/?view=azure-java-stable
+[java8_client_compatibility]: https://learn.microsoft.com/azure/security/fundamentals/azure-ca-details?tabs=root-and-subordinate-cas-list#client-compatibility-for-public-pkis
 
 ![Impressions](https://azure-sdk-impressions.azurewebsites.net/api/impressions/azure-sdk-for-java%2Fsdk%2Fcore%2Fazure-core-amqp%2FREADME.png)
diff --git a/sdk/core/azure-core-experimental/README.md b/sdk/core/azure-core-experimental/README.md
index d1f831b281f9a..782366e735261 100644
--- a/sdk/core/azure-core-experimental/README.md
+++ b/sdk/core/azure-core-experimental/README.md
@@ -9,6 +9,7 @@ Azure Core Experimental contains types that are being evaluated and might eventu
 ### Prerequisites
 
 - A [Java Development Kit (JDK)][jdk_link], version 8 or later.
+  - Here are details about [Java 8 client compatibility with Azure Certificate Authority][java8_client_compatibility].
 
 ### Include the package
 
@@ -52,5 +53,6 @@ For details on contributing to this repository, see the [contributing guide](htt
 <!-- Links -->
 [logging]: https://github.com/Azure/azure-sdk-for-java/wiki/Logging-with-Azure-SDK
 [jdk_link]: https://docs.microsoft.com/java/azure/jdk/?view=azure-java-stable
+[java8_client_compatibility]: https://learn.microsoft.com/azure/security/fundamentals/azure-ca-details?tabs=root-and-subordinate-cas-list#client-compatibility-for-public-pkis
 
 ![Impressions](https://azure-sdk-impressions.azurewebsites.net/api/impressions/azure-sdk-for-java%2Fsdk%2Fcore%2Fazure-core-experimental%2FREADME.png)
diff --git a/sdk/core/azure-core-http-netty/README.md b/sdk/core/azure-core-http-netty/README.md
index 5f57e8f5291d8..0c4ac43426837 100644
--- a/sdk/core/azure-core-http-netty/README.md
+++ b/sdk/core/azure-core-http-netty/README.md
@@ -7,6 +7,7 @@ Azure Core Netty HTTP client is a plugin for the `azure-core` HTTP client API.
 ### Prerequisites
 
 - A [Java Development Kit (JDK)][jdk_link], version 8 or later.
+  - Here are details about [Java 8 client compatibility with Azure Certificate Authority][java8_client_compatibility].
 
 ### Include the package
 #### Include the BOM file
@@ -145,5 +146,6 @@ For details on contributing to this repository, see the [contributing guide](htt
 <!-- Links -->
 [logging]: https://github.com/Azure/azure-sdk-for-java/wiki/Logging-with-Azure-SDK
 [jdk_link]: https://docs.microsoft.com/java/azure/jdk/?view=azure-java-stable
+[java8_client_compatibility]: https://learn.microsoft.com/azure/security/fundamentals/azure-ca-details?tabs=root-and-subordinate-cas-list#client-compatibility-for-public-pkis
 
 ![Impressions](https://azure-sdk-impressions.azurewebsites.net/api/impressions/azure-sdk-for-java%2Fsdk%2Fcore%2Fazure-core-http-netty%2FREADME.png)
diff --git a/sdk/core/azure-core-http-okhttp/README.md b/sdk/core/azure-core-http-okhttp/README.md
index 38cd0dc4098c7..ea8e422064611 100644
--- a/sdk/core/azure-core-http-okhttp/README.md
+++ b/sdk/core/azure-core-http-okhttp/README.md
@@ -7,6 +7,7 @@ Azure Core OkHttp HTTP client is a plugin for the `azure-core` HTTP client API.
 ### Prerequisites
 
 - A [Java Development Kit (JDK)][jdk_link], version 8 or later.
+  - Here are details about [Java 8 client compatibility with Azure Certificate Authority][java8_client_compatibility].
 
 ### Include the package
 #### Include the BOM file
@@ -130,5 +131,6 @@ For details on contributing to this repository, see the [contributing guide](htt
 <!-- Links -->
 [logging]: https://github.com/Azure/azure-sdk-for-java/wiki/Logging-with-Azure-SDK
 [jdk_link]: https://docs.microsoft.com/java/azure/jdk/?view=azure-java-stable
+[java8_client_compatibility]: https://learn.microsoft.com/azure/security/fundamentals/azure-ca-details?tabs=root-and-subordinate-cas-list#client-compatibility-for-public-pkis
 
 ![Impressions](https://azure-sdk-impressions.azurewebsites.net/api/impressions/azure-sdk-for-java%2Fsdk%2Fcore%2Fazure-core-http-okhttp%2FREADME.png)
diff --git a/sdk/core/azure-core-http-vertx/README.md b/sdk/core/azure-core-http-vertx/README.md
index 548c25927f40d..2cd81c06dea2e 100644
--- a/sdk/core/azure-core-http-vertx/README.md
+++ b/sdk/core/azure-core-http-vertx/README.md
@@ -7,6 +7,7 @@ Azure Core Vert.x HTTP client is a plugin for the `azure-core` HTTP client API.
 ### Prerequisites
 
 - A [Java Development Kit (JDK)][jdk_link], version 8 or later.
+  - Here are details about [Java 8 client compatibility with Azure Certificate Authority][java8_client_compatibility].
 
 ### Include the package
 
@@ -83,5 +84,6 @@ For details on contributing to this repository, see the [contributing guide](htt
 <!-- Links -->
 [logging]: https://github.com/Azure/azure-sdk-for-java/wiki/Logging-with-Azure-SDK
 [jdk_link]: https://docs.microsoft.com/java/azure/jdk/?view=azure-java-stable
+[java8_client_compatibility]: https://learn.microsoft.com/azure/security/fundamentals/azure-ca-details?tabs=root-and-subordinate-cas-list#client-compatibility-for-public-pkis
 
 ![Impressions](https://azure-sdk-impressions.azurewebsites.net/api/impressions/azure-sdk-for-java%2Fsdk%2Fcore%2Fazure-core-http-vertx%2FREADME.png)
diff --git a/sdk/core/azure-core-management/README.md b/sdk/core/azure-core-management/README.md
index e00457a6fdee8..c04b116289e7d 100644
--- a/sdk/core/azure-core-management/README.md
+++ b/sdk/core/azure-core-management/README.md
@@ -7,6 +7,7 @@ Azure Core Management library is a collection of classes common to the [Azure Re
 ### Prerequisites
 
 - A [Java Development Kit (JDK)][jdk_link], version 8 or later.
+  - Here are details about [Java 8 client compatibility with Azure Certificate Authority][java8_client_compatibility].
 
 ### Adding the package to your product
 
@@ -58,3 +59,6 @@ For details on contributing to this repository, see the [contributing guide](htt
 [arm]: https://docs.microsoft.com/azure/azure-resource-manager/management/
 [logging]: https://github.com/Azure/azure-sdk-for-java/wiki/Logging-with-Azure-SDK
 [jdk_link]: https://docs.microsoft.com/java/azure/jdk/?view=azure-java-stable
+[java8_client_compatibility]: https://learn.microsoft.com/azure/security/fundamentals/azure-ca-details?tabs=root-and-subordinate-cas-list#client-compatibility-for-public-pkis
+
+![Impressions](https://azure-sdk-impressions.azurewebsites.net/api/impressions/azure-sdk-for-java%2Fsdk%2Fcore%2Fazure-core-management%2FREADME.png)
diff --git a/sdk/core/azure-core-metrics-opentelemetry/README.md b/sdk/core/azure-core-metrics-opentelemetry/README.md
index df94f0c6270dc..81dc7c95be3a1 100644
--- a/sdk/core/azure-core-metrics-opentelemetry/README.md
+++ b/sdk/core/azure-core-metrics-opentelemetry/README.md
@@ -10,6 +10,7 @@ documentation][OpenTelemetry] | [Samples][samples]
 ### Prerequisites
 
 - A [Java Development Kit (JDK)][jdk_link], version 8 or later.
+  - Here are details about [Java 8 client compatibility with Azure Certificate Authority][java8_client_compatibility].
 
 ### Include the package
 
@@ -126,6 +127,7 @@ This project has adopted the [Microsoft Open Source Code of Conduct](https://ope
 [api_documentation]: https://aka.ms/java-docs
 [context]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/core/azure-core/src/main/java/com/azure/core/util/Context.java
 [jdk_link]: https://docs.microsoft.com/java/azure/jdk/?view=azure-java-stable
+[java8_client_compatibility]: https://learn.microsoft.com/azure/security/fundamentals/azure-ca-details?tabs=root-and-subordinate-cas-list#client-compatibility-for-public-pkis
 [logging]: https://github.com/Azure/azure-sdk-for-java/wiki/Logging-with-Azure-SDK
 [source_code]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/core/azure-core-metrics-opentelemetry/src/
 
diff --git a/sdk/core/azure-core-serializer-avro-apache/README.md b/sdk/core/azure-core-serializer-avro-apache/README.md
index 09777936d2e0e..a3bdc415afd07 100644
--- a/sdk/core/azure-core-serializer-avro-apache/README.md
+++ b/sdk/core/azure-core-serializer-avro-apache/README.md
@@ -7,6 +7,7 @@ Azure Core Apache Avro Serializer is a plugin for the `azure-core` `AvroSerializ
 ### Prerequisites
 
 - A [Java Development Kit (JDK)][jdk_link], version 8 or later.
+  - Here are details about [Java 8 client compatibility with Azure Certificate Authority][java8_client_compatibility].
 
 ### Include the package
 
@@ -52,5 +53,6 @@ For details on contributing to this repository, see the [contributing guide](htt
 <!-- links -->
 [logging]: https://github.com/Azure/azure-sdk-for-java/wiki/Logging-with-Azure-SDK
 [jdk_link]: https://docs.microsoft.com/java/azure/jdk/?view=azure-java-stable
+[java8_client_compatibility]: https://learn.microsoft.com/azure/security/fundamentals/azure-ca-details?tabs=root-and-subordinate-cas-list#client-compatibility-for-public-pkis
 
 ![Impressions](https://azure-sdk-impressions.azurewebsites.net/api/impressions/azure-sdk-for-java%2Fsdk%2Fcore%2Fazure-core-serializer-avro-apache%2FREADME.png)
diff --git a/sdk/core/azure-core-serializer-avro-jackson/README.md b/sdk/core/azure-core-serializer-avro-jackson/README.md
index 89db963931249..5801c410c061e 100644
--- a/sdk/core/azure-core-serializer-avro-jackson/README.md
+++ b/sdk/core/azure-core-serializer-avro-jackson/README.md
@@ -7,6 +7,7 @@ Azure Core Jackson Avro Serializer is a plugin for the `azure-core` `AvroSeriali
 ### Prerequisites
 
 - A [Java Development Kit (JDK)][jdk_link], version 8 or later.
+  - Here are details about [Java 8 client compatibility with Azure Certificate Authority][java8_client_compatibility].
 
 ### Include the package
 
@@ -52,6 +53,6 @@ For details on contributing to this repository, see the [contributing guide](htt
 <!-- links -->
 [logging]: https://github.com/Azure/azure-sdk-for-java/wiki/Logging-with-Azure-SDK
 [jdk_link]: https://docs.microsoft.com/java/azure/jdk/?view=azure-java-stable
-
+[java8_client_compatibility]: https://learn.microsoft.com/azure/security/fundamentals/azure-ca-details?tabs=root-and-subordinate-cas-list#client-compatibility-for-public-pkis
 
 ![Impressions](https://azure-sdk-impressions.azurewebsites.net/api/impressions/azure-sdk-for-java%2Fsdk%2Fcore%2Fazure-core-serializer-avro-jackson%2FREADME.png)
diff --git a/sdk/core/azure-core-serializer-json-gson/README.md b/sdk/core/azure-core-serializer-json-gson/README.md
index d7d7807a5b901..8154c64f935be 100644
--- a/sdk/core/azure-core-serializer-json-gson/README.md
+++ b/sdk/core/azure-core-serializer-json-gson/README.md
@@ -7,6 +7,7 @@ Azure Core Gson JSON Serializer is a plugin for the `azure-core` `JsonSerializer
 ### Prerequisites
 
 - A [Java Development Kit (JDK)][jdk_link], version 8 or later.
+  - Here are details about [Java 8 client compatibility with Azure Certificate Authority][java8_client_compatibility].
 
 ### Include the package
 #### Include the BOM file
@@ -84,5 +85,6 @@ For details on contributing to this repository, see the [contributing guide](htt
 <!-- Links -->
 [logging]: https://github.com/Azure/azure-sdk-for-java/wiki/Logging-with-Azure-SDK
 [jdk_link]: https://docs.microsoft.com/java/azure/jdk/?view=azure-java-stable
+[java8_client_compatibility]: https://learn.microsoft.com/azure/security/fundamentals/azure-ca-details?tabs=root-and-subordinate-cas-list#client-compatibility-for-public-pkis
 
 ![Impressions](https://azure-sdk-impressions.azurewebsites.net/api/impressions/azure-sdk-for-java%2Fsdk%2Fcore%2Fazure-core-serializer-json-gson%2FREADME.png)
diff --git a/sdk/core/azure-core-serializer-json-jackson/README.md b/sdk/core/azure-core-serializer-json-jackson/README.md
index b3f7349c0d9ee..762990a9c8057 100644
--- a/sdk/core/azure-core-serializer-json-jackson/README.md
+++ b/sdk/core/azure-core-serializer-json-jackson/README.md
@@ -7,6 +7,7 @@ Azure Core Jackson JSON Serializer is a plugin for the `azure-core` `JsonSeriali
 ### Prerequisites
 
 - A [Java Development Kit (JDK)][jdk_link], version 8 or later.
+  - Here are details about [Java 8 client compatibility with Azure Certificate Authority][java8_client_compatibility].
 
 ### Include the package
 #### Include the BOM file
@@ -84,5 +85,6 @@ For details on contributing to this repository, see the [contributing guide](htt
 <!-- Links -->
 [logging]: https://github.com/Azure/azure-sdk-for-java/wiki/Logging-with-Azure-SDK
 [jdk_link]: https://docs.microsoft.com/java/azure/jdk/?view=azure-java-stable
+[java8_client_compatibility]: https://learn.microsoft.com/azure/security/fundamentals/azure-ca-details?tabs=root-and-subordinate-cas-list#client-compatibility-for-public-pkis
 
 ![Impressions](https://azure-sdk-impressions.azurewebsites.net/api/impressions/azure-sdk-for-java%2Fsdk%2Fcore%2Fazure-core-serializer-json-jackson%2FREADME.png)
diff --git a/sdk/core/azure-core-tracing-opentelemetry/README.md b/sdk/core/azure-core-tracing-opentelemetry/README.md
index be6c3f2ddb252..2a95a8e6af7bb 100644
--- a/sdk/core/azure-core-tracing-opentelemetry/README.md
+++ b/sdk/core/azure-core-tracing-opentelemetry/README.md
@@ -16,6 +16,7 @@ You can enable tracing in Azure client libraries by using and configuring the Op
 ### Prerequisites
 
 - A [Java Development Kit (JDK)][jdk_link], version 8 or later.
+  - Here are details about [Java 8 client compatibility with Azure Certificate Authority][java8_client_compatibility].
 
 ## Key concepts
 
@@ -268,6 +269,7 @@ This project has adopted the [Microsoft Open Source Code of Conduct](https://ope
 [azure-security-keyvault-secrets]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/keyvault/azure-security-keyvault-secrets
 [context]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/core/azure-core/src/main/java/com/azure/core/util/Context.java
 [jdk_link]: https://docs.microsoft.com/java/azure/jdk/?view=azure-java-stable
+[java8_client_compatibility]: https://learn.microsoft.com/azure/security/fundamentals/azure-ca-details?tabs=root-and-subordinate-cas-list#client-compatibility-for-public-pkis
 [logging]: https://github.com/Azure/azure-sdk-for-java/wiki/Logging-with-Azure-SDK
 [OpenTelemetry-quickstart]: https://github.com/open-telemetry/opentelemetry-java/blob/main/QUICKSTART.md
 [OpenTelemetry]: https://github.com/open-telemetry/opentelemetry-java#opentelemetry-for-java
diff --git a/sdk/core/azure-core/README.md b/sdk/core/azure-core/README.md
index 7762ca3b96245..232c0e799390b 100644
--- a/sdk/core/azure-core/README.md
+++ b/sdk/core/azure-core/README.md
@@ -18,6 +18,7 @@ APIs in one client library, you will know how to use them in other client librar
 ### Prerequisites
 
 - A [Java Development Kit (JDK)][jdk_link], version 8 or later.
+  - Here are details about [Java 8 client compatibility with Azure Certificate Authority][java8_client_compatibility].
 
 ### Include the package
 
@@ -260,7 +261,7 @@ the [contributing guide](https://github.com/Azure/azure-sdk-for-java/blob/main/C
 <!-- links -->
 
 [logging]: https://learn.microsoft.com/azure/developer/java/sdk/logging-overview
-
 [jdk_link]: https://docs.microsoft.com/java/azure/jdk/?view=azure-java-stable
+[java8_client_compatibility]: https://learn.microsoft.com/azure/security/fundamentals/azure-ca-details?tabs=root-and-subordinate-cas-list#client-compatibility-for-public-pkis
 
 ![Impressions](https://azure-sdk-impressions.azurewebsites.net/api/impressions/azure-sdk-for-java%2Fsdk%2Fcore%2Fazure-core%2FREADME.png)