From 555e2188df014073127603b5b85dc1e5fbd7244c Mon Sep 17 00:00:00 2001 From: lcawl Date: Mon, 18 Aug 2025 14:28:05 -0700 Subject: [PATCH] Add tip about availability since across majors --- 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 5b43e77804..ef188a38a1 100644 --- a/docs/add-new-api.md +++ b/docs/add-new-api.md @@ -56,7 +56,7 @@ Furthermore, every request definition **must** contain these 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`.