From 9cda0b09742c9ed6ae5e1bccb709b63f32a04f45 Mon Sep 17 00:00:00 2001
From: Julian Gonggrijp <dev@juliangonggrijp.com>
Date: Thu, 15 Apr 2021 14:59:26 +0200
Subject: [PATCH] Add some build clarifications to the documentation (#2923)

---
 index.html | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/index.html b/index.html
index e76d1c507..b7579838d 100644
--- a/index.html
+++ b/index.html
@@ -547,6 +547,14 @@ <h2>v1.13.0 CDN URLs <i style="padding-left: 12px; font-size:12px;">(Use with <t
       </li>
     </ul>
 
+    <p>
+      <i>In most cases, you can replace the version number above by
+      <tt>latest</tt> so that your embed will automatically use the latest
+      version, or <tt>stable</tt> if you want to delay updating until an update
+      has proven to be free of accidental breaking changes. Example:</i><br>
+      <tt>https://cdn.jsdelivr.net/npm/underscore@latest/underscore-umd-min.js</tt>
+    </p>
+
     <h2>Package Installation</h2>
 
     <ul>
@@ -561,6 +569,13 @@ <h2>Package Installation</h2>
       </li>
     </ul>
 
+    <p>
+      <i>If you are hardcoding the path to the file within the package and you
+      are unsure which build to use, it is very likely that you need
+      <tt>underscore-umd.js</tt> or the minified variant
+      <tt>underscore-umd-min.js</tt>.</i>
+    </p>
+
     <h2>Monolithic Import (recommended)</h2>
 
     <ul>