diff --git a/packages/example/src/pages/components/DoDontExample.mdx b/packages/example/src/pages/components/DoDontExample.mdx
index 4ac0925f3..bae5e543c 100644
--- a/packages/example/src/pages/components/DoDontExample.mdx
+++ b/packages/example/src/pages/components/DoDontExample.mdx
@@ -3,6 +3,14 @@ title: DoDontExample
description: Usage instructions for the DoDontExample component
---
+
+
+**Warning:** This component will be deprecated in a future release. Please use
+the [DoDontRow](/components/DoDontRow) and [DoDont](/components/DoDontRow)
+component instead.
+
+
+
The `` component will generally need to be placed inside ``
diff --git a/packages/example/src/pages/components/DoDontRow.mdx b/packages/example/src/pages/components/DoDontRow.mdx
index b29a9a63f..9bcc9491b 100644
--- a/packages/example/src/pages/components/DoDontRow.mdx
+++ b/packages/example/src/pages/components/DoDontRow.mdx
@@ -58,6 +58,31 @@ component, which now includes built in columns.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
## Code
### Image
@@ -99,6 +124,24 @@ component, which now includes built in columns.
```
+### Aspect Ratios
+
+```mdx path=components/DoDontRow/DoDontRow.js src=https://github.com/carbon-design-system/gatsby-theme-carbon/tree/main/packages/gatsby-theme-carbon/src/components/DoDontRow
+
+
+
+
+
+
+
+
+
+
+
+
+
+```
+
## Props
### DoDontRow
@@ -109,13 +152,13 @@ component, which now includes built in columns.
### Do & Dont
-| property | propType | required | default | description |
-| -------------- | -------- | -------- | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| children | node | | | child node, expects a markdown image or `