[docs][guide] writing a multi-asset backed integration (#22910)

- Introduces a guide that walks through the process of building a multi-asset decorator with translator *NOTE:* Once content has been reviewed, I can refactor the snippets to `docs_snippets` for proper linting. --------- Co-authored-by: Erin Cochran <[email protected]>
dagster-io · Aug 23, 2024 · 90c6304 · 90c6304 · github-actions · Aug 23, 2024
1 parent fc81cf5
commit 90c6304
Show file tree

Hide file tree

Showing 3 changed files with 410 additions and 4 deletions.
diff --git a/docs/content/_navigation.json b/docs/content/_navigation.json
@@ -1097,6 +1097,19 @@
           }
         ]
       },
+      {
+        "title": "Integrations",
+        "children": [
+          {
+            "title": "Approaches to writing integrations",
+            "path": "/guides/integrations/approaches-to-writing-integrations"
+          },
+          {
+            "title": "Writing a multi-asset decorator integration",
+            "path": "/guides/integrations/writing-a-multi-asset-decorator-integration"
+          }
+        ]
+      },
       {
         "title": "Working with data assets",
         "children": [

diff --git a/docs/content/guides/integrations/approaches-to-writing-integrations.mdx b/docs/content/guides/integrations/approaches-to-writing-integrations.mdx
@@ -85,7 +85,7 @@ In the scenario where a single API call or configuration can result in multiple
 
 - **Efficiency:** Allows defining multiple assets in a single function, reducing boilerplate code.
 - **Simplicity:** Easier to manage related assets together.
-- **Consistency:** Ensures that related assets are always defined and updated together.
+- **Consistency:** Matches the the developer experience of the Dagster ecosystem by using decorator-based assets.
 
 ### Cons
 
@@ -94,9 +94,7 @@ In the scenario where a single API call or configuration can result in multiple
 
 ### Guide
 
-<Note>
-  A guide for writing a multi-asset decorator based integration is coming soon!
-</Note>
+- [Writing a multi-asset decorator integration](/guides/integrations/writing-a-multi-asset-decorator-integration)
 
 ## Pipes protocol