Merge pull request #2752 from madeline-underwood/enable-meta-description-field

Enable meta description field

Author: pareenaverma

themes/arm-design-system-hugo-theme/layouts/partials/head/head.html

@@ -26,6 +26,15 @@
 <link rel="canonical" href="https://learn.arm.com{{ .Permalink }}" />
 <title>{{ $title }}</title>
 
+{{/* Meta description: short, task-oriented summary for SERP and AI selection.
+     This is intentionally distinct from the JSON-LD description. */}}
+{{- with .Params.description -}}
+  {{- $d := . | plainify | htmlEscape | trim " \t\r\n" -}}
+  {{- if gt (len $d) 0 -}}
+    <meta name="description" content="{{ $d }}">
+  {{- end -}}
+{{- end -}}
+
 {{ partial "head/jsonld.html" . }}
 
 <!-- Include the Arm standard Lato font for machines that don't have by default (Mac) -->

themes/arm-design-system-hugo-theme/layouts/partials/head/jsonld.html

@@ -43,6 +43,7 @@
         "@type"    "Course"
         "name"     .Title
     -}}
+    {{/* Schema description: audience-focused explanation for structured data. This is intentionally distinct from the HTML meta description. */}}
     {{- with .Params.who_is_this_for     }}{{ $j = merge $j (dict "description" ( . | plainify )) }}{{ end -}}
     {{- if $duration                     }}{{ $j = merge $j (dict "timeRequired" $duration) }}{{ end -}}
     {{- with .Params.skilllevels         }}{{ $j = merge $j (dict "educationalLevel" .) }}{{ end -}}