From 41144336747dec19df67c7715ed6c355981ed2b2 Mon Sep 17 00:00:00 2001 From: ZHANG Dapeng Date: Fri, 26 Jul 2019 09:22:53 -0700 Subject: [PATCH] doc: Add hint to users who want an experimental API to be stabilized --- api/src/main/java/io/grpc/ExperimentalApi.java | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/api/src/main/java/io/grpc/ExperimentalApi.java b/api/src/main/java/io/grpc/ExperimentalApi.java index 3ad54b21b2..c7d5eec929 100644 --- a/api/src/main/java/io/grpc/ExperimentalApi.java +++ b/api/src/main/java/io/grpc/ExperimentalApi.java @@ -24,7 +24,10 @@ import java.lang.annotation.Target; /** * Indicates a public API that can change at any time, and has no guarantee of API stability and - * backward-compatibility. + * backward-compatibility. If users want stabilization or signature change of a specific API that + * is currently annotated {@code @ExperimentalApi}, please comment on its tracking issue on github + * with rationale, usecase, and so forth, so that the gRPC team may prioritize the process toward + * stabilization of the API. * *

Usage guidelines: *