[docs-beta] Add API Lifecycle flags for Preview, Beta and Superseded

dagster-io · Nov 25, 2024 · 68c75fd · 68c75fd
1 parent 36c8add
commit 68c75fd
Show file tree

Hide file tree

Showing 5 changed files with 20 additions and 5 deletions.
diff --git a/docs/docs-beta/docs/guides/metadata.md b/docs/docs-beta/docs/guides/metadata.md
@@ -116,9 +116,18 @@ Dagster+ provides rich visualization and navigation of column lineage in the Ass
 
 ## Linking assets with source code \{#source-code}
 
-import Experimental from '../partials/\_Experimental.md';
+import Preview from '../partials/\_Preview.md';
+
+<Preview />
+
+import Beta from '../partials/\_Beta.md';
+
+<Beta />
+
+import Superseded from '../partials/\_Superseded.md';
+
+<Superseded />
 
-<Experimental />
 
 To link assets with their source code, you can attach a **code reference**. Code references are a type of metadata that allow you to easily view those assets' source code from the Dagster UI, both in local development and in production.
 

diff --git a/docs/docs-beta/docs/partials/_Beta.md b/docs/docs-beta/docs/partials/_Beta.md
@@ -0,0 +1,3 @@
+:::warning
+This feature is considered in a beta stage. It is still being tested and may change.
+:::
diff --git a/docs/docs-beta/docs/partials/_Experimental.md b/docs/docs-beta/docs/partials/_Experimental.md
diff --git a/docs/docs-beta/docs/partials/_Preview.md b/docs/docs-beta/docs/partials/_Preview.md
@@ -0,0 +1,3 @@
+:::warning
+This feature is considered in a preview stage and is under active development. It can change significantly, or be removed completely. It is not for production use.
+:::
diff --git a/docs/docs-beta/docs/partials/_Superseded.md b/docs/docs-beta/docs/partials/_Superseded.md
@@ -0,0 +1,3 @@
+:::warning
+This feature is considered superseded and is still available, but is no longer the best practice.
+:::