update docs to newer RFC
@@ -190,11 +190,13 @@ typedef struct az_iot_hub_client_properties
* @brief Initializes the Telemetry or C2D properties.
*
* @note The properties init API will not encode properties. In order to support
- * the following characters:
- * `/ % # &`
- * the onus is on the application to properly url encode them (RFC 2396). Only these characters
- * would have to be encoded. If you would like to avoid the need to encode the names/values,
- * avoid using these characters in names and values.
+ * the following characters, they must be percent-encoded (RFC3986) as follows:
+ * `/` : `%2F`
+ * `%` : `%25`
+ * `#` : `%23`
+ * `&` : `%26`
+ * Only these characters would have to be encoded. If you would like to avoid the need to
+ * encode the names/values, avoid using these characters in names and values.
*
* @param[in] properties The #az_iot_hub_client_properties to initialize
* @param[in] buffer Can either be an empty #az_span or an #az_span containing properly formatted
@@ -209,11 +211,13 @@ az_iot_hub_client_properties_init(az_iot_hub_client_properties* properties, az_s
* @brief Appends a key-value property to the list of properties.
*
* @note The properties append API will not encode properties. In order to support
- * the following characters:
- * `/ % # &`
- * the onus is on the application to properly url encode them (RFC 2396). Only these characters
- * would have to be encoded. If you would like to avoid the need to encode the names/values,
- * avoid using these characters in names and values.
+ * the following characters, they must be percent-encoded (RFC3986) as follows:
+ * `/` : `%2F`
+ * `%` : `%25`
+ * `#` : `%23`
+ * `&` : `%26`
+ * Only these characters would have to be encoded. If you would like to avoid the need to
+ * encode the names/values, avoid using these characters in names and values.
*
* @param[in] properties The #az_iot_hub_client_properties to use for this call
* @param[in] name The name of the property.
