From 51979c9563b3ffacedd4a9d86db1687686faa494 Mon Sep 17 00:00:00 2001 From: Lisa Cawley Date: Tue, 19 Aug 2025 00:00:48 -0700 Subject: [PATCH] Add tip about availability since across majors (#5149) (cherry picked from commit 12a57e2af2fef349d9fa0818d7c796e26cf8ce56) --- docs/add-new-api.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/add-new-api.md b/docs/add-new-api.md index 031cd13148..5e082cab87 100644 --- a/docs/add-new-api.md +++ b/docs/add-new-api.md @@ -56,7 +56,7 @@ Furthermore, every request definition **must** contain three JS Doc tags: - `stability`: the API stability, one of `experimental`, `beta`, `stable` - `visibility`: the API stability, one of `public` or `private`. - `since`: the version of Elasticsearch when the API has been introduced (eg: `7.7.0`). - This field is only available for `stack`. + This field is only available for `stack`. If the API is introduced in multiple major versions (eg: `8.19.0` and `9.1.0`), use the appropriate value in each branch. - `feature_flag`: the feature flag value, only valid if the `visibility` is set to `feature_flag`. This field is only available for `stack`.