docs: enhance accessibility by adding aria-labels

risk: low

Author: ParzivalPavlis

docs/assets/icons/external-link.svg

@@ -41,11 +41,12 @@ body {
         margin-top: 2em;
         margin-bottom: 1em;
 
-        &[id]:before {
-            @include mq(large) {
-                height: 179px;
-                margin-top: -179px;
-            }
+        &[id] {
+            scroll-margin-top: 179px;
+        }
+
+        &[id]::before {
+            display: none;
         }
 
         a {

docs/assets/scss/typography.scss

@@ -16,7 +16,7 @@
   {{ else }}
     {{ if $currentPage.NextInSection }}
       {{ with $currentPage.NextInSection }}
-        <a href="{{ .RelPermalink }}" class="gd-docs-prev-next-pages__link gd-docs-prev-next-pages__prev">
+        <a href="{{ .RelPermalink }}" class="gd-docs-prev-next-pages__link gd-docs-prev-next-pages__prev" aria-label="{{ .LinkTitle }} (Prev article)">
           <span class="gd-docs-prev-next-pages__chevron">{{ with resources.Get "icons/chevron.svg" }}{{ ( . | minify).Content | safeHTML }}{{ end }}</span>
           {{ .LinkTitle }}
         </a>
@@ -32,15 +32,15 @@
 
   {{ if $currentPage.IsSection }}
     {{ with index $currentPage.Pages.ByWeight 0 }}
-      <a href="{{ .RelPermalink }}" class="gd-docs-prev-next-pages__link gd-docs-prev-next-pages__next">
+      <a href="{{ .RelPermalink }}" class="gd-docs-prev-next-pages__link gd-docs-prev-next-pages__next" aria-label="{{ .LinkTitle }} (Next article)">
         <span class="gd-docs-prev-next-pages__chevron">{{ with resources.Get "icons/chevron.svg" }}{{ ( . | minify).Content | safeHTML }}{{ end }}</span>
         {{ .LinkTitle }}
       </a>
     {{ end }}
   {{ else }}
     {{ if $currentPage.PrevInSection }}
       {{ with $currentPage.PrevInSection }}
-        <a href="{{ $currentPage.PrevInSection.RelPermalink }}" class="gd-docs-prev-next-pages__link gd-docs-prev-next-pages__next">
+        <a href="{{ $currentPage.PrevInSection.RelPermalink }}" class="gd-docs-prev-next-pages__link gd-docs-prev-next-pages__next" aria-label="{{ .LinkTitle }} (Next article)">
           <span class="gd-docs-prev-next-pages__chevron">{{ with resources.Get "icons/chevron.svg" }}{{ ( . | minify).Content | safeHTML }}{{ end }}</span>
           {{ $currentPage.PrevInSection.LinkTitle }}
         </a>