all: add tracking issues for all experimental APIs and make it required

core/src/main/java/io/grpc/ExperimentalApi.java

@@ -53,5 +53,5 @@
   /**
    * Context information such as links to discussion thread, tracking issue etc.
    */
-  String value() default "";
+  String value();
 }

core/src/main/java/io/grpc/Metadata.java

@@ -366,7 +366,7 @@ public <T> Iterable<T> removeAll(Key<T> key) {
    * Remove all values for the given key without returning them. This is a minor performance
    * optimization if you do not need the previous values.
    */
-  @ExperimentalApi
+  @ExperimentalApi("https://github.com/grpc/grpc-java/issues/4691")
   public <T> void discardAll(Key<T> key) {
     if (isEmpty()) {
       return;

core/src/main/java/io/grpc/SecurityLevel.java

@@ -19,7 +19,7 @@
 /**
  * The level of security guarantee in communications.
  */
-@ExperimentalApi
+@ExperimentalApi("https://github.com/grpc/grpc-java/issues/4692")
 public enum SecurityLevel {
   /**
    * No security guarantee.

core/src/main/java/io/grpc/Status.java

@@ -408,7 +408,7 @@ public static Status fromThrowable(Throwable t) {
    *
    * @return the trailers or {@code null} if not found.
    */
-  @ExperimentalApi
+  @ExperimentalApi("https://github.com/grpc/grpc-java/issues/4683")
   public static Metadata trailersFromThrowable(Throwable t) {
     Throwable cause = checkNotNull(t, "t");
     while (cause != null) {

core/src/main/java/io/grpc/StatusException.java

@@ -28,13 +28,20 @@ public class StatusException extends Exception {
   private final Status status;
   private final Metadata trailers;
 
+  /**
+   * Constructs an exception with both a status.  See also {@link Status#asException()}.
+   *
+   * @since 1.0.0
+   */
   public StatusException(Status status) {
     this(status, null);
   }
 
   /**
    * Constructs an exception with both a status and trailers.  See also
    * {@link Status#asException(Metadata)}.
+   *
+   * @since 1.0.0
    */
   public StatusException(Status status, @Nullable Metadata trailers) {
     super(Status.formatThrowableMessage(status), status.getCause());
@@ -44,15 +51,18 @@ public StatusException(Status status, @Nullable Metadata trailers) {
 
   /**
    * Returns the status code as a {@link Status} object.
+   *
+   * @since 1.0.0
    */
   public final Status getStatus() {
     return status;
   }
 
   /**
    * Returns the received trailers.
+   *
+   * @since 1.0.0
    */
-  @ExperimentalApi
   public final Metadata getTrailers() {
     return trailers;
   }

core/src/main/java/io/grpc/StatusRuntimeException.java

@@ -29,13 +29,20 @@ public class StatusRuntimeException extends RuntimeException {
   private final Status status;
   private final Metadata trailers;
 
+  /**
+   * Constructs the exception with both a status.  See also {@link Status#asException()}.
+   *
+   * @since 1.0.0
+   */
   public StatusRuntimeException(Status status) {
     this(status, null);
   }
 
   /**
    * Constructs the exception with both a status and trailers.  See also
    * {@link Status#asException(Metadata)}.
+   *
+   * @since 1.0.0
    */
   public StatusRuntimeException(Status status, @Nullable Metadata trailers) {
     super(Status.formatThrowableMessage(status), status.getCause());
@@ -45,15 +52,18 @@ public StatusRuntimeException(Status status, @Nullable Metadata trailers) {
 
   /**
    * Returns the status code as a {@link Status} object.
+   *
+   * @since 1.0.0
    */
   public final Status getStatus() {
     return status;
   }
 
   /**
    * Returns the received trailers.
+   *
+   * @since 1.0.0
    */
-  @ExperimentalApi
   public final Metadata getTrailers() {
     return trailers;
   }

protobuf/src/main/java/io/grpc/protobuf/StatusProto.java

@@ -28,7 +28,7 @@
 import javax.annotation.Nullable;
 
 /** Utility methods for working with {@link com.google.rpc.Status}. */
-@ExperimentalApi
+@ExperimentalApi("https://github.com/grpc/grpc-java/issues/4695")
 public final class StatusProto {
   private StatusProto() {}
 

services/src/main/java/io/grpc/services/HealthStatusManager.java

@@ -27,7 +27,7 @@
  * {@link #getHealthService()} method.
  * The health status manager can update the health statuses of the server.
  */
-@io.grpc.ExperimentalApi
+@io.grpc.ExperimentalApi("https://github.com/grpc/grpc-java/issues/4696")
 public final class HealthStatusManager {
 
   private final HealthServiceImpl healthService;

stub/src/main/java/io/grpc/stub/ClientResponseObserver.java

@@ -22,7 +22,7 @@
  * Specialization of {@link StreamObserver} implemented by clients in order to interact with the
  * advanced features of a call such as flow-control.
  */
-@ExperimentalApi
+@ExperimentalApi("https://github.com/grpc/grpc-java/issues/4693")
 public interface ClientResponseObserver<ReqT, RespT> extends StreamObserver<RespT> {
   /**
    * Called by the runtime priot to the start of a call to provide a reference to the

stub/src/main/java/io/grpc/stub/StreamObservers.java

@@ -24,7 +24,7 @@
  * Utility functions for working with {@link StreamObserver} and it's common subclasses like
  * {@link CallStreamObserver}.
  */
-@ExperimentalApi
+@ExperimentalApi("https://github.com/grpc/grpc-java/issues/4694")
 public final class StreamObservers {
   /**
    * Copy the values of an {@link Iterator} to the target {@link CallStreamObserver} while properly