From dcd13a8e31675e0798a0ba528e825470c597cc21 Mon Sep 17 00:00:00 2001
From: Mark Otto <markdotto@gmail.com>
Date: Wed, 6 Apr 2022 17:35:31 -0700
Subject: Revert border-color utilities to use the CSS property instead of the
 variable

---
 scss/_utilities.scss                       | 3 +--
 site/content/docs/5.1/utilities/borders.md | 6 ++++++
 2 files changed, 7 insertions(+), 2 deletions(-)

diff --git a/scss/_utilities.scss b/scss/_utilities.scss
index 3705f92ab3..9e60529098 100644
--- a/scss/_utilities.scss
+++ b/scss/_utilities.scss
@@ -148,8 +148,7 @@ $utilities: map-merge(
       )
     ),
     "border-color": (
-      css-var: true,
-      css-variable-name: border-color,
+      property: border-color,
       class: border,
       values: $utilities-border-colors
     ),
diff --git a/site/content/docs/5.1/utilities/borders.md b/site/content/docs/5.1/utilities/borders.md
index 6939dcdf8a..17d353b322 100644
--- a/site/content/docs/5.1/utilities/borders.md
+++ b/site/content/docs/5.1/utilities/borders.md
@@ -43,6 +43,12 @@ Change the border color using utilities built on our theme colors.
 <span class="border border-white"></span>
 {{< /example >}}
 
+{{< callout >}}
+Unlike text and background color utilities, border color utilities redeclare the `border-color` property **without** an additional `--bs-border-opacity`, as opposed to resetting only `--bs-border-color`. This ensures the backward compatibility of border color utilities applying to other components while providing additional functionality through CSS variables.
+
+This will be revisited in a future major release.
+{{< /callout >}}
+
 ## Opacity
 
 {{< added-in "5.2.0" >}}
-- 
cgit v1.2.3