From f8e179403307ea04ea76940ffcbe6f07a82f0dd8 Mon Sep 17 00:00:00 2001
From: Daniel McCloy <dan@mccloy.info>
Date: Wed, 27 Jul 2022 23:10:55 -0500
Subject: [PATCH] DOC: Add comment to deprecate some CSS in future (#848)

---
 src/pydata_sphinx_theme/assets/styles/content/_admonitions.scss | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/src/pydata_sphinx_theme/assets/styles/content/_admonitions.scss b/src/pydata_sphinx_theme/assets/styles/content/_admonitions.scss
index d285f2e3d..4cb78cc94 100644
--- a/src/pydata_sphinx_theme/assets/styles/content/_admonitions.scss
+++ b/src/pydata_sphinx_theme/assets/styles/content/_admonitions.scss
@@ -196,6 +196,8 @@ div.admonition,
     // Undo the .sidebar directive border
     border-width: 0 0 0 0.2rem;
 
+    // TODO: these semantic-color-names border-color rules might no longer be
+    //       needed when we drop support for Sphinx 4 / docutils 0.17
     &.attention,
     &.caution,
     &.warning {