Soft deprecation

src/main/java/software/amazon/awssdk/crt/mqtt/MqttClient.java

@@ -11,12 +11,19 @@
 import software.amazon.awssdk.crt.io.TlsContext;
 
 /**
+ * <p><b>Deprecated.</b> We strongly recommend using {@link software.amazon.awssdk.crt.mqtt5.Mqtt5Client}.</p>
+ *
+ * <p>There are no current plans to fully deprecate the MQTT 3.1.1 client but it is highly recommended
+ * customers migrate to the MQTT5 client to access a more robust feature set, clearer error handling,
+ * and lifetime management. More details can be found in the GitHub Repo FAQ</p>
+ * 
  * This class wraps aws-c-mqtt to provide the basic MQTT pub/sub functionalities
  * via the AWS Common Runtime
  * 
  * One MqttClient class is needed per application. It can create any number of connections to
  * any number of MQTT endpoints
  */
+@Deprecated
 public class MqttClient extends CrtResource {
 
     private TlsContext tlsContext;

src/main/java/software/amazon/awssdk/crt/mqtt/MqttClientConnection.java

@@ -22,12 +22,19 @@
 import java.util.function.Consumer;
 
 /**
+ * <p><b>Deprecated.</b> We strongly recommend using {@link software.amazon.awssdk.crt.mqtt5.Mqtt5Client}.</p>
+ *
+ * <p>There are no current plans to fully deprecate the MQTT 3.1.1 client but it is highly recommended
+ * customers migrate to the MQTT5 client to access a more robust feature set, clearer error handling,
+ * and lifetime management. More details can be found in the GitHub Repo FAQ</p>
+ * 
  * This class wraps aws-c-mqtt to provide the basic MQTT pub/sub functionality
  * via the AWS Common Runtime
  *
  * MqttClientConnection represents a single connection from one MqttClient to an
  * MQTT service endpoint
  */
+@Deprecated
 public class MqttClientConnection extends CrtResource {
 
     private static final int MAX_PORT = 65535;