diff --git a/src/partials/header.html b/src/partials/header.html
index 87d8f5b77..247505021 100644
--- a/src/partials/header.html
+++ b/src/partials/header.html
@@ -20,7 +20,7 @@
   IN THE SOFTWARE.
 -->
 
-<!-- Determine site url to mitigate a MkDocs bugs -->
+<!-- Mitigate bug: https://github.com/mkdocs/mkdocs/issues/2191 -->
 {% set site_url = config.site_url | default(nav.homepage.url, true) | url %}
 {% if not config.use_directory_urls and site_url == "." %}
   {% set site_url = site_url ~ "/index.html" %}
diff --git a/src/partials/nav.html b/src/partials/nav.html
index 4136c98c4..a5f0cfbc1 100644
--- a/src/partials/nav.html
+++ b/src/partials/nav.html
@@ -20,7 +20,7 @@
   IN THE SOFTWARE.
 -->
 
-<!-- Determine site url to mitigate a MkDocs bugs -->
+<!-- Mitigate bug: https://github.com/mkdocs/mkdocs/issues/2191 -->
 {% set site_url = config.site_url | default(nav.homepage.url, true) | url %}
 {% if not config.use_directory_urls and site_url == "." %}
   {% set site_url = site_url ~ "/index.html" %}