From 03ab97a8d9b6d75b126cb228699478e4a74d2438 Mon Sep 17 00:00:00 2001
From: Laura Griffee <laura@mailzone.com>
Date: Fri, 4 Feb 2022 12:40:10 -0700
Subject: [PATCH] Create migration guidance for shadow() and tokens

---
 .../guides/migrating-from-v8-to-v9.md         | 35 ++++++++++++++++---
 1 file changed, 31 insertions(+), 4 deletions(-)

diff --git a/documentation/guides/migrating-from-v8-to-v9.md b/documentation/guides/migrating-from-v8-to-v9.md
index b01d101d03d..6c2e3bbe9d3 100644
--- a/documentation/guides/migrating-from-v8-to-v9.md
+++ b/documentation/guides/migrating-from-v8-to-v9.md
@@ -93,13 +93,40 @@ A list of functions/mixins and their value equivalents or new token values.
 
 | Function                     | Replacement Value/Token                |
 | ---------------------------- | -------------------------------------- |
-| `easing()`<br>`easing(base)` | `var(--p-ease)`                        |
-| `easing(in)`                 | `var(--p-ease-in)`                     |
-| `easing(out)`                | `var(--p-ease-out)`                    |
-| `easing(excite)`             | `var(--p-ease-excite)`                 |
+| `easing()`<br>`easing(base)` | `--p-ease`                             |
+| `easing(in)`                 | `--p-ease-in`                          |
+| `easing(out)`                | `--p-ease-out`                         |
+| `easing(excite)`             | `--p-ease-excite`                      |
 | `easing(overshoot)`          | `cubic-bezier(0.07, 0.28, 0.32, 1.22)` |
 | `easing(anticipate)`         | `cubic-bezier(0.38, -0.4, 0.88, 0.65)` |
 
+#### `shadow()`
+
+| Function                     | Replacement Value/Token  |
+| ---------------------------- | ------------------------ |
+| `shadow(faint)`              | `--p-shadow-faint`       |
+| `shadow()`<br>`shadow(base)` | `--p-shadow-base`        |
+| `shadow(deep)`               | `--p-shadow-deep`        |
+| `shadow(layer)`              | `--p-shadow-layer`       |
+| `shadow(transparent)`        | `--p-shadow-transparent` |
+
+## Tokens
+
+### Shadow
+
+| Token                             | Replacement Value/Token            |
+| --------------------------------- | ---------------------------------- |
+| `--p-card-shadow`                 | `--p-shadow-card`                  |
+| `--p-popover-shadow`              | `--p-shadow-popover`               |
+| `--p-modal-shadow`                | `--p-shadow-modal`                 |
+| `--p-top-bar-shadow`              | `--p-shadow-top-bar`               |
+| `--p-button-drop-shadow`          | `--p-shadow-button`                |
+| `--p-button-inner-shadow`         | `--p-shadows-inset-button`         |
+| `--p-button-pressed-inner-shadow` | `--p-shadows-inset-button-pressed` |
+| `--p-shadow-from-ambient-light`   | `rgba(23, 24, 24, 0.05)`           |
+| `--p-shadow-from-direct-light`    | `rgba(0, 0, 0, 0.15)`              |
+| `--p-shadow-from-dim-light`       | `rgba(0, 0, 0, 0.2)`               |
+
 ## Removal of the public scss api
 
 Any functions that were being consumed from `build/styles/_public-api.scss` have been removed. The functions can be found in the following permalinks.