docs: update meta description

docs/Makefile

@@ -110,7 +110,7 @@ pa11y: pa11y-install html
 	find $(BUILDDIR) -name *.html -print0 | xargs -n 1 -0 $(PA11Y)
 
 lint-md: pymarkdownlnt-install
-	@. $(VENV); pymarkdownlnt --config $(SPHINXDIR)/.pymarkdown.json scan --recurse --exclude=./$(SPHINXDIR)/** $(SOURCEDIR)
+	@. $(VENV); pymarkdownlnt --config $(SPHINXDIR)/.pymarkdown.json scan --recurse --exclude=$(SPHINXDIR) $(SOURCEDIR)
 
 vale-install: install
 	@. $(VENV); test -f $(VALE_CONFIG) || python3 $(SPHINXDIR)/get_vale_conf.py

docs/explanation/index.md

@@ -1,3 +1,9 @@
+---
+myst:
+  html_meta:
+    description: "Ubuntu kernel development processes, security policies, and stable release updates. Explore explanations of kernel sources and workflows."
+---
+
 # Explanation
 
 The explanatory guides in this section talk about different aspects of the

docs/explanation/post-release-updates.md

@@ -1,3 +1,9 @@
+---
+myst:
+  html_meta:
+    description: "Learn Ubuntu kernel security and update policies for post-release trees. Understand SRU criteria, patch submission process, and archive updates."
+---
+
 # Kernel security and update policy for post-release trees
 
 This document describes the process and criteria for post-release kernel updates.

docs/explanation/stable-release-updates.md

@@ -1,3 +1,9 @@
+---
+myst:
+  html_meta:
+    description: "Understand Ubuntu kernel stable release updates (SRU). Learn about the 4/2 cycle cadence, patch submission, review process, and kernel streams."
+---
+
 # About kernel stable release updates (SRU)
 
 Every supported kernel for an Ubuntu release is part of a Stable Release Updates

docs/explanation/ubuntu-linux-kernel-sources.md

@@ -1,3 +1,9 @@
+---
+myst:
+  html_meta:
+    description: "Overview of Ubuntu Linux kernel source repository structure, how to find Launchpad Git URLs, branches, and protocols for accessing source code."
+---
+
 # About Ubuntu Linux kernel sources
 
 Ubuntu Linux kernel source packages are essential for users and developers who

docs/how-to/develop-customise/build-kernel-snap.md

@@ -1,3 +1,9 @@
+---
+myst:
+  html_meta:
+    description: "Learn to build Ubuntu Linux kernel snaps. Follow detailed instructions for creating snap packages from kernel source code for local testing and development."
+---
+
 # How to build an Ubuntu Linux kernel snap
 
 If you are running an Ubuntu Core system and want to use boot into a custom

docs/how-to/develop-customise/build-kernel.md

@@ -1,3 +1,9 @@
+---
+myst:
+  html_meta:
+    description: "Step-by-step guide to build an Ubuntu Linux kernel from source. Learn prerequisites, configuration, customization, and installation procedures."
+---
+
 # How to build an Ubuntu Linux kernel
 
 If you have patches you need to apply to the Ubuntu Linux kernel, or you want to

docs/how-to/develop-customise/index.md

@@ -1,3 +1,9 @@
+---
+myst:
+  html_meta:
+    description: "Build and customize Ubuntu kernels. Follow guides for building kernel packages and snaps across different platforms and architectures."
+---
+
 # Development and customization
 
 These guides cover how to build kernel packages, kernel snaps, and kernel

docs/how-to/index.md

@@ -1,3 +1,9 @@
+---
+myst:
+  html_meta:
+    description: "Guides for Ubuntu kernel development. Learn how to obtain source code, build kernels, test in -proposed versions, and contribute to the documentation."
+---
+
 # How-to guides
 
 These guides accompany through the various stages and building and publishing

docs/how-to/source-code/enable-source-repositories.md

@@ -1,3 +1,9 @@
+---
+myst:
+  html_meta:
+    description: "Enable Ubuntu kernel source package repositories. Learn to configure sources.list or ubuntu.sources for kernel development and building."
+---
+
 # How to enable kernel source package repositories
 
 If you want to build or modify an Ubuntu kernel package from source, you will first need the kernel source code.
@@ -31,7 +37,6 @@ file. If not, add or uncomment these lines for your Ubuntu release.
 deb-src http://archive.ubuntu.com/ubuntu jammy main
 deb-src http://archive.ubuntu.com/ubuntu jammy-updates main
 ```
-````
 `````
 
 ## Update package list

docs/how-to/source-code/index.md

@@ -1,3 +1,9 @@
+---
+myst:
+  html_meta:
+    description: "Find out where to obtain kernel sources via Git, enable repositories, and send patches to the mailing list."
+---
+
 # Source code access and management
 
 These guides cover processes related to obtaining kernel source trees and

docs/how-to/source-code/obtain-kernel-source-git.md

@@ -1,3 +1,9 @@
+---
+myst:
+  html_meta:
+    description: "Obtain Ubuntu kernel source code using Git. Follow step-by-step instructions for cloning kernel repositories for any Ubuntu release."
+---
+
 # How to obtain kernel source for an Ubuntu release using Git
 
 The kernel source code for each Ubuntu release is maintained in its own

docs/how-to/source-code/send-patches.rst

@@ -1,3 +1,6 @@
+.. meta::
+   :description: Submit kernel patches to the Ubuntu kernel team mailing list. Learn formatting requirements, review process, and best practices for patches.
+
 .. _how-to-send-patches:
 
 How to send patches to the mailing-list

docs/how-to/testing-verification/test-kernel-in-proposed.md

@@ -1,3 +1,9 @@
+---
+myst:
+  html_meta:
+    description: "Learn to enable -proposed pocket, install test kernels, and verify stability of kernels before release."
+---
+
 # How to test kernels in -proposed
 
 Ubuntu kernels are uploaded to the -proposed pocket for testing before being

docs/index.md

@@ -1,3 +1,9 @@
+---
+myst:
+  html_meta:
+    description: "Official Ubuntu kernel documentation. Learn to build, customize, and contribute to Ubuntu kernels. Understand the cadence for stable release updates and HWE kernels."
+---
+
 # Ubuntu Kernel documentation
 
 The Ubuntu Linux kernel is the core software enabling applications on Ubuntu to

docs/reference/dkms-upload-rights.rst

@@ -1,3 +1,6 @@
+.. meta::
+   :description: DKMS (Dynamic Kernel Module Support) upload rights for Ubuntu. Understand permissions, responsibilities, and application procedures.
+
 DKMS upload rights
 ##################
 

docs/reference/glossary.md

@@ -1,3 +1,9 @@
+---
+myst:
+  html_meta:
+    description: "Ubuntu kernel terminology glossary. Find definitions for SRU, DKMS, HWE, edge kernels, and other kernel development terms. Quick reference guide."
+---
+
 # Kernel glossary
 
 This page is a running list of terminology that is frequently used when talking

docs/reference/hwe-kernels.rst

@@ -1,3 +1,6 @@
+.. meta::
+   :description: Hardware Enablement (HWE) kernels for Ubuntu LTS releases. Learn about support lifecycles, installation procedures, and edge kernel variants.
+
 HWE kernels
 ===========
 

docs/reference/index.md

@@ -1,3 +1,9 @@
+---
+myst:
+  html_meta:
+    description: "Reference guides for Ubuntu kernel development processes. Explore kernel variants, patch formats, acceptance criteria, upload rights, and terminology."
+---
+
 # Reference
 
 Reference material about Ubuntu kernel development processes, terminology, and

docs/reference/kernel-upload-rights.rst

@@ -1,3 +1,6 @@
+.. meta::
+   :description: Ubuntu kernel upload rights and permissions. Learn about access levels, responsibilities, and how to obtain upload privileges for kernels.
+
 .. _kernel-upload-rights:
 
 Kernel upload rights

docs/reference/oem-kernels.rst

@@ -1,3 +1,6 @@
+.. meta::
+   :description: OEM kernels for Ubuntu hardware partners. Understand specialized kernels for pre-installed systems, staging processes, and release timelines.
+
 OEM kernels
 ===========
 

docs/reference/patch-acceptance-criteria.rst

@@ -1,3 +1,6 @@
+.. meta::
+   :description: Understand Ubuntu kernel patch acceptance criteria. Learn what patches are accepted for stable releases and the evaluation process used.
+
 .. highlight:: email
 
 .. _ubuntu-patches-acceptance-criteria:

docs/reference/stable-patch-format.rst

@@ -1,3 +1,6 @@
+.. meta::
+   :description: Ubuntu kernel stable patch format requirements. Learn proper structure, SRU justification, commit messages, and submission guidelines.
+
 Stable patch format
 ===================
 

docs/reference/ubuntu-kernels.md

@@ -1,3 +1,9 @@
+---
+myst:
+  html_meta:
+    description: "Understand Ubuntu kernel variants including development, optimized, OEM, and HWE kernels. Learn about git branching strategies and lifecycles."
+---
+
 (ref-ubuntu-kernel-variants-branches)=
 
 # Ubuntu kernel variants and branches
@@ -134,6 +140,7 @@ The `master-next` or `main-next` branches serve as the staging area for the **ne
 The `master` or `main` branches represent the current state of the kernel source as it exists in the `-updates` pocket of the Ubuntu archive.
 It contains the linear history of all the stable releases published for that kernel.
 
+
 % LINKS
 
 [Ubuntu kernels from Canonical]: https://ubuntu.com/kernel