From 50693ae729fac3eadda11de5094f5dc353023388 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Julien=20D=C3=A9ramond?= <julien.deramond@orange.com>
Date: Fri, 15 Sep 2023 06:39:50 +0200
Subject: [PATCH] =?UTF-8?q?chore(merge=20main):=20patched=20commit=20?=
 =?UTF-8?q?=E2=86=92=20317cb2a=20(#2244)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .cspell.json                                      |  1 +
 site/content/docs/5.3/getting-started/download.md | 14 ++++++++++----
 site/layouts/_default/examples.html               |  4 ++++
 3 files changed, 15 insertions(+), 4 deletions(-)

diff --git a/.cspell.json b/.cspell.json
index 8c7c9c2c19..79907fa3d6 100644
--- a/.cspell.json
+++ b/.cspell.json
@@ -43,6 +43,7 @@
     "dropright",
     "dropstart",
     "dropup",
+    "dgst",
     "errorf",
     "evenodd",
     "favicon",
diff --git a/site/content/docs/5.3/getting-started/download.md b/site/content/docs/5.3/getting-started/download.md
index 8be0264d2f..d6093c6ea5 100644
--- a/site/content/docs/5.3/getting-started/download.md
+++ b/site/content/docs/5.3/getting-started/download.md
@@ -62,13 +62,19 @@ Make sure to use [`preconnect` resource hint](https://www.w3.org/TR/resource-hin
 
 We recommend [jsDelivr](https://www.jsdelivr.com/) and use it ourselves in our documentation. However, in some cases—like in some specific countries or environments—you may need to use other CDN providers like [cdnjs](https://cdnjs.com/) or [unpkg](https://unpkg.com/).
 
-You'll find the same files on these CDN providers, albeit with different URLs. When changing the URLs, you'll also need to update the `integrity` attribute. Tools like [SRI Hash Generator](https://www.srihash.org/) can help you generate the correct values.
+You'll find the same files on these CDN providers, albeit with different URLs. With cdnjs, you can [use this direct Boosted package link](https://cdnjs.com/libraries/boosted) to copy and paste ready-to-use HTML snippets for each dist file from any version of Boosted.
 
-With cdnjs, you can [use this direct Boosted package link](https://cdnjs.com/libraries/boosted) to copy and paste ready-to-use HTML snippets for each dist file from any version of Boosted.
+{{< callout warning>}}
+**If the SRI hashes differ for a given file, you shouldn't use the files from that CDN, because it means that the file was modified by someone else.**
+{{< /callout >}}
 
-## Package managers
+Note that you should compare same length hashes, e.g. `sha384` with `sha384`, otherwise it's expected for them to be different.
+As such, you can use an online tool like [SRI Hash Generator](https://www.srihash.org/) to make sure that the hashes are the same for a given file.
+Alternatively, assuming you have OpenSSL installed, you can achieve the same from the CLI, for example:
 
-Pull in Boosted's **source files** into nearly any project with some of the most popular package managers. No matter the package manager, Boosted will **require a [Sass compiler]({{< docsref "/getting-started/contribute#sass" >}}) and [Autoprefixer](https://github.com/postcss/autoprefixer)** for a setup that matches our official compiled versions.
+```sh
+openssl dgst -sha384 -binary boosted.min.js | openssl base64 -A
+```
 
 ### npm
 
diff --git a/site/layouts/_default/examples.html b/site/layouts/_default/examples.html
index de61a041c7..5690e9a1f8 100644
--- a/site/layouts/_default/examples.html
+++ b/site/layouts/_default/examples.html
@@ -78,6 +78,10 @@
       .bd-mode-toggle {
         z-index: 1500;
       }
+
+      .bd-mode-toggle .dropdown-menu .active .bi {
+        display: block !important;
+      }
     </style>
 
     {{ range .Page.Params.extra_css }}