From e8d0c940ebb6cc780ec426ffcc992a0f0ac43a57 Mon Sep 17 00:00:00 2001 From: shainaraskas Date: Mon, 26 Jan 2026 17:04:51 -0500 Subject: [PATCH] dimensions docs-builder edition --- docs/syntax/applies.md | 19 +++++++++++-------- 1 file changed, 11 insertions(+), 8 deletions(-) diff --git a/docs/syntax/applies.md b/docs/syntax/applies.md index 833410400..cf08ea351 100644 --- a/docs/syntax/applies.md +++ b/docs/syntax/applies.md @@ -30,20 +30,25 @@ Where: ### Page level -Page level annotations are added in the YAML frontmatter, starting with the `applies_to` key and following the [key-value reference](#key-value-reference). For example: +Page level annotations are added in the YAML frontmatter, starting with the `applies_to` key and following the [key-value reference](#key-value-reference). + +All documentation pages must include an `applies_to` tag in the YAML frontmatter. + +:::{note} +In the page front matter, you should only refer to one dimension (stack/serverless, deployment, or product). Refer to the [cumulative documentation guidelines](https://www.elastic.co/docs/contribute-docs/how-to/cumulative-docs/guidelines#dimensions) for details. +::: + +For example: ```yaml --- applies_to: stack: ga - deployment: - ece: ga --- ``` -:::{important} -All documentation pages must include an `applies_to` tag in the YAML frontmatter. -::: + +For more examples, refer to [Page annotation examples](#page-annotation-examples). ### Section level @@ -221,8 +226,6 @@ Versioned products require a `version` tag to be used with the `lifecycle` tag: ```yaml applies_to: stack: preview 9.1, ga 9.4 - deployment: - ece: deprecated 9.2, removed 9.8 ``` :::{include} _snippets/versioned-lifecycle.md