service client deprecation

Author: sbSteveK

sdk/src/main/java/software/amazon/awssdk/iot/iotidentity/IotIdentityClient.java

@@ -38,11 +38,17 @@
 import java.util.function.Consumer;
 
 /**
+ * <p><b>Deprecated.</b> We strongly recommend using {@link software.amazon.awssdk.iot.iotidentity.IotIdentityV2Client }. </p>
+ *
+ * <p>There are no current plans to ully deprecate IotIdentityClient but it is highly recommended customers
+ * migrate to IotIdentityV2Client. More details can be found in the GitHub Repo FAQ.</p>
+ *
  * An AWS IoT service that assists with provisioning a device and installing unique client certificates on it
  *
  * AWS documentation: https://docs.aws.amazon.com/iot/latest/developerguide/provision-wo-cert.html
  *
 */
+@Deprecated
 public class IotIdentityClient {
     private MqttClientConnection connection = null;
     private final Gson gson = getGson();

sdk/src/main/java/software/amazon/awssdk/iot/iotjobs/IotJobsClient.java

@@ -50,11 +50,17 @@
 import java.util.function.Consumer;
 
 /**
+ * <p><b>Deprecated.</b> We strongly recommend using {@link software.amazon.awssdk.iot.iotjobs.IotJobsV2Client }. </p>
+ *
+ * <p>There are no current plans to ully deprecate IotJobsClient but it is highly recommended customers
+ * migrate to IotJobsV2Client. More details can be found in the GitHub Repo FAQ.</p>
+ *
  * The AWS IoT jobs service can be used to define a set of remote operations that are sent to and executed on one or more devices connected to AWS IoT.
  *
  * AWS documentation: https://docs.aws.amazon.com/iot/latest/developerguide/jobs-api.html#jobs-mqtt-api
  *
 */
+@Deprecated
 public class IotJobsClient {
     private MqttClientConnection connection = null;
     private final Gson gson = getGson();

sdk/src/main/java/software/amazon/awssdk/iot/iotshadow/IotShadowClient.java

@@ -56,11 +56,17 @@
 import java.util.function.Consumer;
 
 /**
+ * <p><b>Deprecated.</b> We strongly recommend using {@link software.amazon.awssdk.iot.iotshadow.IotShadowV2Client }. </p>
+ *
+ * <p>There are no current plans to ully deprecate IotShadowClient but it is highly recommended customers
+ * migrate to IotShadowV2Client. More details can be found in the GitHub Repo FAQ.</p>
+ *
  * The AWS IoT Device Shadow service adds shadows to AWS IoT thing objects. Shadows are a simple data store for device properties and state.  Shadows can make a device’s state available to apps and other services whether the device is connected to AWS IoT or not.
  *
  * AWS documentation: https://docs.aws.amazon.com/iot/latest/developerguide/device-shadow-mqtt.html
  *
 */
+@Deprecated
 public class IotShadowClient {
     private MqttClientConnection connection = null;
     private final Gson gson = getGson();