[docs] add brief storage kind docs (#22328)

## Summary Adds a brief docs section about storage kind tags. I notice we don't have a similar section for compute kind - maybe we should wait until after these can be asset tags (#22188) ## Test Plan vercel --------- Co-authored-by: Erin Cochran <[email protected]>
dagster-io · Jun 7, 2024 · deee4e3 · deee4e3 · github-actions · Jun 7, 2024
1 parent 6fc07c3
commit deee4e3
Show file tree

Hide file tree

Showing 7 changed files with 28 additions and 0 deletions.
diff --git a/docs/content/api/modules.json.gz b/docs/content/api/modules.json.gz
diff --git a/docs/content/api/searchindex.json.gz b/docs/content/api/searchindex.json.gz
diff --git a/docs/content/api/sections.json.gz b/docs/content/api/sections.json.gz
diff --git a/docs/content/concepts/metadata-tags/tags.mdx b/docs/content/concepts/metadata-tags/tags.mdx
@@ -62,6 +62,24 @@ def leads(): ...
 
 Other APIs that define assets can also accept tag arguments, such as <PyObject object="AssetSpec" />, <PyObject object="AssetOut" />, <PyObject object="AssetOut" />, and <PyObject object="graph_asset" decorator />.
 
+#### Storage kind tags
+
+You can attach the `dagster/storage_kind` tag to an asset to specify the storage technology used to store the asset. For example, `s3` or `snowflake`.
+
+```python file=/concepts/metadata-tags/tags.py startafter=start_asset_storage_kind_tag endbefore=end_asset_storage_kind_tag
+@asset(tags={"dagster/storage_kind": "snowflake"})
+def users(): ...
+```
+
+These tags will appear in the asset graph and can be used to filter assets in the Dagster UI:
+
+<Image
+alt="An asset with a storage kind tag in the Dagster UI"
+src="/images/concepts/metadata-tags/storage-kind-tag.png"
+width={758}
+height={303}
+/>
+
 ### Jobs
 
 Adding tags to a job will attach them to every run executed by the job.

diff --git a/docs/next/public/images/concepts/metadata-tags/storage-kind-tag.png b/docs/next/public/images/concepts/metadata-tags/storage-kind-tag.png
diff --git a/docs/next/public/objects.inv b/docs/next/public/objects.inv
diff --git a/examples/docs_snippets/docs_snippets/concepts/metadata-tags/tags.py b/examples/docs_snippets/docs_snippets/concepts/metadata-tags/tags.py
@@ -9,6 +9,16 @@ def leads(): ...
 
 # end_asset_tags
 
+
+# start_asset_storage_kind_tag
+
+
+@asset(tags={"dagster/storage_kind": "snowflake"})
+def users(): ...
+
+
+# end_asset_storage_kind_tag
+
 # start_asset_job_tags
 
 asset_job = define_asset_job(