Fix the doc issues in url_atteibutes.h

Author: zurex

api/include/opentelemetry/semconv/url_attributes.h

@@ -25,8 +25,8 @@ namespace url
 static constexpr const char *kUrlFragment = "url.fragment";
 
 /**
- * Absolute URL describing a network resource according to <a
- * href="https://www.rfc-editor.org/rfc/rfc3986">RFC3986</a> <p> For network calls, URL usually has
+ * Absolute URL describing a network resource according to 
+ * <a href="https://www.rfc-editor.org/rfc/rfc3986">RFC3986</a> <p> For network calls, URL usually has
  * @code scheme://host[:port][path][?query][#fragment] @endcode format, where the fragment is not
  * transmitted over HTTP, but if it is known, it SHOULD be included nevertheless. <p>
  * @code url.full @endcode MUST NOT contain credentials passed via URL in form of @code
@@ -40,15 +40,14 @@ static constexpr const char *kUrlFragment = "url.fragment";
  * Query string values for the following keys SHOULD be redacted by default and replaced by the
  * value @code REDACTED @endcode:
  * <ul>
- *   <li><a
- * href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/RESTAuthentication.html#RESTAuthenticationQueryStringAuth">@code
- * AWSAccessKeyId @endcode</a></li> <li><a
- * href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/RESTAuthentication.html#RESTAuthenticationQueryStringAuth">@code
- * Signature @endcode</a></li> <li><a
- * href="https://learn.microsoft.com/azure/storage/common/storage-sas-overview#sas-token">@code sig
- * @endcode</a></li> <li><a
- * href="https://cloud.google.com/storage/docs/access-control/signed-urls">@code X-Goog-Signature
- * @endcode</a></li>
+ *   <li>
+ * <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/RESTAuthentication.html#RESTAuthenticationQueryStringAuth"> @code AWSAccessKeyId @endcode</a>
+ * </li> <li>
+ * <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/RESTAuthentication.html#RESTAuthenticationQueryStringAuth"> @code Signature @endcode</a>
+ * </li> <li>
+ * <a href="https://learn.microsoft.com/azure/storage/common/storage-sas-overview#sas-token"> @code sig @endcode</a>
+ * </li> <li>
+ * <a href="https://cloud.google.com/storage/docs/access-control/signed-urls"> @code X-Goog-Signature @endcode</a></li>
  * </ul>
  * <p>
  * This list is subject to change over time.
@@ -67,21 +66,18 @@ static constexpr const char *kUrlFull = "url.full";
 static constexpr const char *kUrlPath = "url.path";
 
 /**
- * The <a href="https://www.rfc-editor.org/rfc/rfc3986#section-3.4">URI query</a> component
+ * The <a href="https://www.rfc-editor.org/rfc/rfc3986#section-3.4">URI query</a> component @link https://learn.microsoft.com/azure/storage/common/storage-sas-overview#sas-token @code sig @endcode @endlink
  * <p>
  * Sensitive content provided in @code url.query @endcode SHOULD be scrubbed when instrumentations
  * can identify it. <p>
  *
  * Query string values for the following keys SHOULD be redacted by default and replaced by the
- * value @code REDACTED @endcode: <ul> <li><a
- * href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/RESTAuthentication.html#RESTAuthenticationQueryStringAuth">@code
- * AWSAccessKeyId @endcode</a></li> <li><a
- * href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/RESTAuthentication.html#RESTAuthenticationQueryStringAuth">@code
- * Signature @endcode</a></li> <li><a
- * href="https://learn.microsoft.com/azure/storage/common/storage-sas-overview#sas-token">@code sig
- * @endcode</a></li> <li><a
- * href="https://cloud.google.com/storage/docs/access-control/signed-urls">@code X-Goog-Signature
- * @endcode</a></li>
+ * value @code REDACTED @endcode: <ul> <li>
+ * <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/RESTAuthentication.html#RESTAuthenticationQueryStringAuth"> @code AWSAccessKeyId @endcode</a>
+ * </li> <li>
+ * <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/RESTAuthentication.html#RESTAuthenticationQueryStringAuth"> @code Signature @endcode</a></li> <li>
+ * <a href="https://learn.microsoft.com/azure/storage/common/storage-sas-overview#sas-token"> @code sig @endcode</a></li> <li>
+ * <a href="https://cloud.google.com/storage/docs/access-control/signed-urls"> @code X-Goog-Signature @endcode</a></li>
  * </ul>
  * <p>
  * This list is subject to change over time.