From a0259fa0ecc15f119085ec7cb018c160d671446e Mon Sep 17 00:00:00 2001
From: Carl Mensah <carl@etch.co>
Date: Fri, 13 Sep 2024 14:48:27 +0100
Subject: [PATCH] docs: z-index intention comments

---
 components/control/Button/Button.css | 1 +
 1 file changed, 1 insertion(+)

diff --git a/components/control/Button/Button.css b/components/control/Button/Button.css
index 52295cd..d7a6210 100644
--- a/components/control/Button/Button.css
+++ b/components/control/Button/Button.css
@@ -57,6 +57,7 @@ diamond-button {
     &:not(:active):focus-visible {
       outline-offset: var(--diamond-button-outline-offset);
       position: relative;
+      /* This z-index prevents the focus outline from being clipped by the parent */
       z-index: 1;
     }
   }