From 0ae5b433073845b5a68bba6f653230e453230405 Mon Sep 17 00:00:00 2001
From: lcawl <lcawley@elastic.co>
Date: Wed, 7 Jun 2023 09:32:07 -0700
Subject: [PATCH 1/2] [DOCS] Update modeling-guide.md

---
 docs/modeling-guide.md | 11 +----------
 1 file changed, 1 insertion(+), 10 deletions(-)

diff --git a/docs/modeling-guide.md b/docs/modeling-guide.md
index d6da26f623..a094de524c 100644
--- a/docs/modeling-guide.md
+++ b/docs/modeling-guide.md
@@ -664,16 +664,7 @@ class Foo {
 
 #### `@stability`
 
-You can mark a class or property of a type as stable/beta/experimental with this tag (the default is stable).
-
-```ts
-class Foo {
-  bar: string
-  /** @stability experimental */
-  baz?: string
-  faz: string
-}
-```
+Use `@availability` instead.
 
 #### `@visibility`
 

From 22f5e26b712ca9d49b4bb0ba1a124b49db2e3069 Mon Sep 17 00:00:00 2001
From: Seth Michael Larson <seth.larson@elastic.co>
Date: Wed, 7 Jun 2023 12:49:28 -0500
Subject: [PATCH 2/2] Update modeling-guide.md

---
 docs/modeling-guide.md | 19 ++-----------------
 1 file changed, 2 insertions(+), 17 deletions(-)

diff --git a/docs/modeling-guide.md b/docs/modeling-guide.md
index a094de524c..e0ca5d56db 100644
--- a/docs/modeling-guide.md
+++ b/docs/modeling-guide.md
@@ -662,21 +662,6 @@ class Foo {
 }
 ```
 
-#### `@stability`
+#### `@stability` and `@visibility`
 
-Use `@availability` instead.
-
-#### `@visibility`
-
-You can mark a request as `public`/`feature_flag`/`private` with this tag (the default is `public`).
-
-```ts
-/**
- * @rest_spec_name namespace.api
- * @availability stack since=7.5.0
- * @visibility private
- */
-export interface Request extends RequestBase {
- ...
-}
-```
+These annotations have been removed, use `@availability` instead.