diff --git a/docs/assets/scss/theme/content.scss b/docs/assets/scss/theme/content.scss
index 6b929ba1de5..2827731ba95 100644
--- a/docs/assets/scss/theme/content.scss
+++ b/docs/assets/scss/theme/content.scss
@@ -23,6 +23,9 @@
 
   >h2:not(:first-child) {
     margin-top: 48px;
+
+    // Scroll margin calculation for desktop:
+    // nav height (80px) + margin-top (48px)
     scroll-margin-top: 128px;
 
     @media screen and (max-width: 767px) {
@@ -32,6 +35,9 @@
 
   >h2+h3 {
     margin-top: 20px;
+
+    // Scroll margin calculation for desktop:
+    // nav height (80px) + margin-top (20px)
     scroll-margin-top: 100px;
 
     @media screen and (max-width: 767px) {
@@ -46,6 +52,9 @@
     margin-bottom: 12px;
     margin-top: 28px !important;
     font-weight: 600;
+
+    // Scroll margin calculation for desktop:
+    // nav height (80px) + margin-top (28px)
     scroll-margin-top: 108px;
 
     @media screen and (max-width: 767px) {