diff --git a/api/src/main/java/io/grpc/ClientStreamTracer.java b/api/src/main/java/io/grpc/ClientStreamTracer.java
index eb6ffb19b0..6259522487 100644
--- a/api/src/main/java/io/grpc/ClientStreamTracer.java
+++ b/api/src/main/java/io/grpc/ClientStreamTracer.java
@@ -62,7 +62,8 @@ public abstract class ClientStreamTracer extends StreamTracer {
      *        method.  It should not be saved because it is not safe for read or write after the
      *        method returns.
      *
-     * @deprecated use {@link #newClientStreamTracer(StreamInfo, Metadata)} instead
+     * @deprecated use {@link
+     * #newClientStreamTracer(io.grpc.ClientStreamTracer.StreamInfo, io.grpc.Metadata)} instead.
      */
     @Deprecated
     public ClientStreamTracer newClientStreamTracer(CallOptions callOptions, Metadata headers) {
diff --git a/api/src/main/java/io/grpc/LoadBalancerProvider.java b/api/src/main/java/io/grpc/LoadBalancerProvider.java
index a6aa64f297..2b2db7a6dc 100644
--- a/api/src/main/java/io/grpc/LoadBalancerProvider.java
+++ b/api/src/main/java/io/grpc/LoadBalancerProvider.java
@@ -70,7 +70,8 @@ public abstract class LoadBalancerProvider extends LoadBalancer.Factory {
    *     policy choice.
    * @return a tuple of the fully parsed and validated balancer configuration, else the Status.
    * @since 1.20.0
-   * @see https://github.com/grpc/proposal/blob/master/A24-lb-policy-config.md
+   * @see <a href="https://github.com/grpc/proposal/blob/master/A24-lb-policy-config.md">
+   *   A24-lb-policy-config.md</a>
    */
   public ConfigOrError parseLoadBalancingPolicyConfig(Map<String, ?> rawLoadBalancingPolicyConfig) {
     return UNKNOWN_CONFIG;