From 5e270a13d1b35a81925a1067c89b082708c713ef Mon Sep 17 00:00:00 2001
From: Luke-zhang-04 <luke.zhang2004dev@gmail.com>
Date: Sun, 19 Jul 2020 21:08:41 +0300
Subject: docs: add info on modifying and adding utilities

---
 site/content/docs/5.0/utilities/api.md | 42 ++++++++++++++++++++++++++++++++++
 1 file changed, 42 insertions(+)

diff --git a/site/content/docs/5.0/utilities/api.md b/site/content/docs/5.0/utilities/api.md
index 7dd0d6ede5..aee021b4fb 100644
--- a/site/content/docs/5.0/utilities/api.md
+++ b/site/content/docs/5.0/utilities/api.md
@@ -212,3 +212,45 @@ $utilities: (
   "float": null,
 );
 ```
+
+## Adding to existing utilities
+
+Add new utilities with `map-merge`.Start by importing the utilities stylesheet, then use `map-merge` to add new properties and values.s
+
+```scss
+@import "bootstrap/scss/utilities";
+
+$utilities: map-merge(
+  $utilities,
+  (
+    "font-size": (
+      responsive: true,
+      property: font-weight,
+      values: $display-font-sizes,
+    )
+  )
+);
+```
+
+## Modifying existing utilities
+
+Modify existing utilities with `map-get` and `map-merge`. Once again, be sure to import the utilities stylesheet before your custom utilities.
+
+```scss
+@import "bootstrap/scss/utilities";
+
+$utilities: map-merge(
+  $utilities,
+  (
+    "width": map-merge(
+      map-get($utilities, "width"),
+      (
+        values: map-merge(
+          map-get(map-get($utilities, "width"), "values"),
+          (10: 10%),
+        ),
+      ),
+    ),
+  )
+);
+```
-- 
cgit v1.2.3