diff --git a/packages/components/docs/sass.md b/packages/components/docs/sass.md
index 6735c7a1472b..38dc6265dc4b 100644
--- a/packages/components/docs/sass.md
+++ b/packages/components/docs/sass.md
@@ -1506,13 +1506,15 @@ $carbon--aspect-ratios: ((16, 9), (2, 1), (4, 3), (1, 1), (1, 2));
 
 ### ❌carbon--aspect-ratio [mixin]
 
+Generates the CSS classname utilities for the aspect ratios
+
 Output the CSS classes for generating aspect ratio classes
 
 <details>
 <summary>Source code</summary>
 
 ```scss
-@mixin carbon--aspect-ratio($aspect-ratios: $carbon--aspect-ratios) {
+@mixin carbon--aspect-ratio($width, $height) {
   .#{$prefix}--aspect-ratio {
     height: 0;
     position: relative;
diff --git a/packages/elements/docs/sass.md b/packages/elements/docs/sass.md
index f2f1a3cd332d..929a8b8eb376 100644
--- a/packages/elements/docs/sass.md
+++ b/packages/elements/docs/sass.md
@@ -1350,13 +1350,18 @@ $carbon--aspect-ratios: ((16, 9), (2, 1), (4, 3), (1, 1), (1, 2));
 
 ### ❌carbon--aspect-ratio [mixin]
 
+Generates the CSS classname utilities for the aspect ratios
+
+CSS Tricks article on aspect ratios and all the different ways it can be done.
+https://css-tricks.com/aspect-ratio-boxes/#article-header-id-6
+
 Output the CSS classes for generating aspect ratio classes
 
 <details>
 <summary>Source code</summary>
 
 ```scss
-@mixin carbon--aspect-ratio($aspect-ratios: $carbon--aspect-ratios) {
+@mixin carbon--aspect-ratio($width, $height) {
   .#{$prefix}--aspect-ratio {
     height: 0;
     position: relative;
diff --git a/packages/grid/docs/sass.md b/packages/grid/docs/sass.md
index 1463f0dd8bfa..463cb96b762f 100644
--- a/packages/grid/docs/sass.md
+++ b/packages/grid/docs/sass.md
@@ -384,13 +384,18 @@ $carbon--aspect-ratios: ((16, 9), (2, 1), (4, 3), (1, 1), (1, 2));
 
 ### ❌carbon--aspect-ratio [mixin]
 
+Generates the CSS classname utilities for the aspect ratios
+
+CSS Tricks article on aspect ratios and all the different ways it can be done.
+https://css-tricks.com/aspect-ratio-boxes/#article-header-id-6
+
 Output the CSS classes for generating aspect ratio classes
 
 <details>
 <summary>Source code</summary>
 
 ```scss
-@mixin carbon--aspect-ratio($aspect-ratios: $carbon--aspect-ratios) {
+@mixin carbon--aspect-ratio($width, $height) {
   .#{$prefix}--aspect-ratio {
     height: 0;
     position: relative;