From 3ffe4f82b794e174fafe58d80980aa37bc02e5e4 Mon Sep 17 00:00:00 2001
From: ysds <fellows3@gmail.com>
Date: Mon, 12 Feb 2018 07:24:47 +0900
Subject: [PATCH] Update themeing docs for more clearly how to remove from map
 (#25589)

* Add note about insert position of "map-remove"

* Use optional keys instead of required keys
---
 docs/4.0/getting-started/theming.md | 15 +++++++++++++--
 1 file changed, 13 insertions(+), 2 deletions(-)

diff --git a/docs/4.0/getting-started/theming.md b/docs/4.0/getting-started/theming.md
index 9e6c88eaef..48d1b058f7 100644
--- a/docs/4.0/getting-started/theming.md
+++ b/docs/4.0/getting-started/theming.md
@@ -120,10 +120,21 @@ $theme-colors: (
 
 #### Remove from map
 
-To remove colors from `$theme-colors`, or any other map, use `map-remove`:
+To remove colors from `$theme-colors`, or any other map, use `map-remove`. Be aware you must insert it between our requirements and options:
 
 {% highlight scss %}
-$theme-colors: map-remove($theme-colors, "success", "info", "danger");
+// Required
+@import "node_modules/bootstrap/scss/functions";
+@import "node_modules/bootstrap/scss/variables";
+@import "node_modules/bootstrap/scss/mixins";
+
+$theme-colors: map-remove($theme-colors, "info", "light", "dark");
+
+// Optional
+@import "node_modules/bootstrap/scss/root";
+@import "node_modules/bootstrap/scss/reboot";
+@import "node_modules/bootstrap/scss/type";
+...
 {% endhighlight %}
 
 #### Required keys