diff --git a/docs/explanation/how-snaps-work/index.md b/docs/explanation/how-snaps-work/index.md index af5c24d..3d47f0a 100644 --- a/docs/explanation/how-snaps-work/index.md +++ b/docs/explanation/how-snaps-work/index.md @@ -1,3 +1,9 @@ +--- +myst: + html_meta: + description: Explanatory and conceptual guides for snap packages - discussion and clarification of key topics for snap users and snap package developers, including how snaps work, interface connections, update management and security. +--- + (explanation-how-snaps-work-index)= # How snaps work diff --git a/docs/explanation/index.md b/docs/explanation/index.md index 5fe1357..0a17639 100644 --- a/docs/explanation/index.md +++ b/docs/explanation/index.md @@ -1,3 +1,9 @@ +--- +myst: + html_meta: + description: Explanatory and conceptual guides for snap packages - discussion and clarification of key topics for snap users and snap package developers, including how snaps work, interface connections, update management and security. +--- + (explanation-index)= # Explanation diff --git a/docs/explanation/interfaces/index.md b/docs/explanation/interfaces/index.md index 423d348..4dced91 100644 --- a/docs/explanation/interfaces/index.md +++ b/docs/explanation/interfaces/index.md @@ -1,7 +1,12 @@ +--- +myst: + html_meta: + description: Explanations of how the snap interface system works, including how interfaces are used to manage access to resources, and how interface hooks can be used to control what happens when an interface is used. +--- + (explanation-interfaces-index)= # Interfaces - As you begin to use snaps more, interfaces can be used to carefully permit and limit access to resources. * {ref}`All about interfaces `: The permission system used to manage access to resources. diff --git a/docs/explanation/security/index.md b/docs/explanation/security/index.md index eeba3ad..6844141 100644 --- a/docs/explanation/security/index.md +++ b/docs/explanation/security/index.md @@ -1,3 +1,9 @@ +--- +myst: + html_meta: + description: Learn about how snaps use standard Linux security policies to isolate themselves from the system, and from each other. Understand snap confinement, security policies and the snapd release process. +--- + (explanation-security-index)= # Security diff --git a/docs/how-to-guides/index.md b/docs/how-to-guides/index.md index 30c4bf7..e56a5e6 100644 --- a/docs/how-to-guides/index.md +++ b/docs/how-to-guides/index.md @@ -1,3 +1,9 @@ +--- +myst: + html_meta: + description: Step-by-step guides covering key operations and common tasks for snap users and snap package developers, including how to manage updates, connect interfaces, control services and more. +--- + (how-to-guides-index)= # How-to guides diff --git a/docs/how-to-guides/manage-snaps/index.md b/docs/how-to-guides/manage-snaps/index.md index 148c358..81a343a 100644 --- a/docs/how-to-guides/manage-snaps/index.md +++ b/docs/how-to-guides/manage-snaps/index.md @@ -1,3 +1,9 @@ +--- +myst: + html_meta: + description: Step-by-step guides on how to manage snap packages - control when snaps update, connect interfaces, set system options, control services and more for snap users and snap package developers. +--- + (how-to-guides-manage-snaps-index)= # Manage snaps diff --git a/docs/how-to-guides/snap-development/index.md b/docs/how-to-guides/snap-development/index.md index 973b4b3..061efce 100644 --- a/docs/how-to-guides/snap-development/index.md +++ b/docs/how-to-guides/snap-development/index.md @@ -1,3 +1,9 @@ +--- +myst: + html_meta: + description: Extend snap functionality with API access, internal tools, and customised environments for your applications and devices. Learn how to use the SnapD REST API, snapctl, test snapd fixes, debug snaps, use snap try and in-development features. +--- + (how-to-snap-development)= # Snap development diff --git a/docs/index.md b/docs/index.md index 1a7f123..3b1e83f 100644 --- a/docs/index.md +++ b/docs/index.md @@ -1,3 +1,9 @@ +--- +myst: + html_meta: + description: Official snap packaging documentation - comprehensive guides for installation, configuration, security, package updates and removal management, alongside technical details on all snap packaging features for snap users and snap package developers. +--- + (ref-index_snap-documentation)= # Snap documentation diff --git a/docs/reference/administration/index.md b/docs/reference/administration/index.md index 28377d4..0a876e1 100644 --- a/docs/reference/administration/index.md +++ b/docs/reference/administration/index.md @@ -1,3 +1,9 @@ +--- +myst: + html_meta: + description: Deepen your understanding of how snaps can run on all kinds of devices, in all kinds of environments. Learn about system options, data locations, distribution support, network requirements and more for snap users and snap package developers. +--- + (reference-administration-index)= # Administration diff --git a/docs/reference/development/index.md b/docs/reference/development/index.md index 6e255c8..dea8559 100644 --- a/docs/reference/development/index.md +++ b/docs/reference/development/index.md @@ -1,3 +1,9 @@ +--- +myst: + html_meta: + description: Extend snap functionality with API access and customised environments for your applications and devices. Learn about environment variables, the SnapD REST API, YAML schemas and more for snap users and snap package developers. +--- + (reference-development-index)= # Development diff --git a/docs/reference/development/yaml-schemas/index.md b/docs/reference/development/yaml-schemas/index.md index ed25ebf..c805ccd 100644 --- a/docs/reference/development/yaml-schemas/index.md +++ b/docs/reference/development/yaml-schemas/index.md @@ -1,3 +1,9 @@ +--- +myst: + html_meta: + description: YAML schemas for snap packages, including the snap.yaml format, and the gadget and kernel snap formats for device development. +--- + (reference-development-yaml-schemas-index)= # YAML schemas diff --git a/docs/reference/index.md b/docs/reference/index.md index b6b15e9..f1c155b 100644 --- a/docs/reference/index.md +++ b/docs/reference/index.md @@ -1,3 +1,9 @@ +--- +myst: + html_meta: + description: Complete reference documentation for snap packages - technical details on all snap packaging features for snap users and snap package developers, including the snapd REST API, YAML schemas, system architecture and more. +--- + (reference-index)= # Reference diff --git a/docs/reference/interfaces/index.md b/docs/reference/interfaces/index.md index 490a083..1bf0eca 100644 --- a/docs/reference/interfaces/index.md +++ b/docs/reference/interfaces/index.md @@ -1,3 +1,9 @@ +--- +myst: + html_meta: + description: Every snap interface in a single place. Learn about the interfaces available to snap users and snap package developers, including how they work, how to use them, and how to manage them. +--- + (ref-index_interfaces)= # Interfaces diff --git a/docs/tutorials/get-started.md b/docs/tutorials/get-started.md index 0c5f091..7de8f27 100644 --- a/docs/tutorials/get-started.md +++ b/docs/tutorials/get-started.md @@ -1,3 +1,10 @@ +--- +myst: + html_meta: + description: Learn how to list, find, install, run, update and remove snap packages with a hands-on introduction to using snap packages for new users. +--- + + (tutorials-get-started)= # Get started diff --git a/docs/tutorials/index.md b/docs/tutorials/index.md index 41e1ec1..f4d3035 100644 --- a/docs/tutorials/index.md +++ b/docs/tutorials/index.md @@ -1,3 +1,9 @@ +--- +myst: + html_meta: + description: Getting started with snap packages - learn how to install the snap daemon, and install and configure your first snap packages with step-by-step tutorials. +--- + (tutorials-index)= # Tutorials diff --git a/docs/tutorials/install-the-daemon/index.md b/docs/tutorials/install-the-daemon/index.md index 669223e..8e44797 100644 --- a/docs/tutorials/install-the-daemon/index.md +++ b/docs/tutorials/install-the-daemon/index.md @@ -1,3 +1,9 @@ +--- +myst: + html_meta: + description: Installation instructions for the snap daemon (snapd) - the background service that manages and maintains your snaps. Snapd is pre-installed on many Linux distributions, and easy to install on most others. Find installation instructions for your distribution here. +--- + (tutorials-install-the-daemon-index)= # Install the daemon