Move examples

Author: theletterf

docs/syntax/_snippets/inline-level-applies-examples.md

@@ -56,9 +56,9 @@ This example shows how to use directly a key from the second level of the `appli
 
 ::::{tab-item} Output
 
-- {applies_to}`{ serverless: "ga" , stack: "ga 9.1.0" }`
-- {applies_to}`{ edot_python: "preview 1.7.0" , apm_agent_java: "beta 1.0.0" }`
-- {applies_to}`{ stack: "ga 9.0" , deployment: { eck: "ga 9.0" } }`
+- {applies_to}`serverless: ga` {applies_to}`stack: ga 9.1.0`
+- {applies_to}`edot_python: preview 1.7.0, ga 1.8.0` {applies_to}`apm_agent_java: beta 1.0.0, ga 1.2.0`
+- {applies_to}`stack: ga 9.0` {applies_to}`eck: ga 3.0`
 
 ::::
 
@@ -71,30 +71,5 @@ This example shows how to use directly a key from the second level of the `appli
 ::::
 
 :::::
-
 ::::::
 
-::::::{dropdown} Complex scenarios with different product types
-
-:::::{tab-set}
-
-::::{tab-item} Output
-
-- {applies_to}`{ stack: "preview 9.1", product: { edot_python: "preview 1.4.0" } }`
-
-Notice that, when mixing different statement types, the applies_to inline syntax requires JSON-like nesting for product-specific applicability.
-
-::::
-
-::::{tab-item} Markdown
-```markdown
-- {applies_to}`{ stack: "preview 9.1", product: { edot_python: "preview 1.4.0" } }`
-```
-
-Notice that, when mixing different statement types, the applies_to inline syntax requires JSON-like nesting for product-specific applicability.
-
-::::
-
-:::::
-
-::::::

docs/syntax/applies.md

@@ -29,31 +29,26 @@ Where:
 - The lifecycle is mandatory.
 - The version is optional.
 
-:::{important}
-All documentation pages must include an `applies_to` tag in the YAML frontmatter. Use YAML frontmatter to indicate each deployment target's availability and lifecycle status. For a complete list of supported keys and values, see the [frontmatter syntax guide](./frontmatter.md).
-:::
+### Page level
 
-### Versioned products
+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:
 
-Versioned products require a `version` tag to be used with the `lifecycle` tag:
-
-```
+```yaml
+---
 applies_to:
-  stack: preview 9.1, ga 9.4
+  stack: ga
   deployment:
-    ece: deprecated 9.2, removed 9.8
+    ece: ga
+---
 ```
 
-Unversioned products use `lifecycle` tags without a version:
+For more examples, refer to [Page annotation examples](#page-annotation-examples).
 
-```
-applies_to:
-  serverless:
-    elasticsearch: beta
-    observability: removed
-```
+:::{important}
+All documentation pages must include an `applies_to` tag in the YAML frontmatter.
+:::
 
-### Section annotations
+### Section level
 
 A header can be followed by an `{applies_to}` directive which contextualizes the applicability of the section further.
 
@@ -75,11 +70,13 @@ stack: ga 9.1
 
 This allows the YAML inside the `{applies_to}` directive to be fully highlighted.
 
+For more examples, refer to [Section annotation examples](#section-annotation-examples).
+
 :::{note}
 The `{applies_to}` directive must be preceded by a heading directly.
 :::
 
-### Inline annotations
+### Inline level
 
 You can add inline applies annotations to any line using the following syntax:
 
@@ -95,6 +92,8 @@ Property {preview}`<version>`
 :   definition body
 ```
 
+For more examples, refer to [Inline annotation examples](#inline-annotation-examples).
+
 ## Key-value reference
 
 Use the following key-value reference to find the appropriate key and value for your applicability statements.
@@ -125,6 +124,26 @@ Use the following key-value reference to find the appropriate key and value for
 
 ## Examples
 
+### Versioning examples
+
+Versioned products require a `version` tag to be used with the `lifecycle` tag:
+
+```
+applies_to:
+  stack: preview 9.1, ga 9.4
+  deployment:
+    ece: deprecated 9.2, removed 9.8
+```
+
+Unversioned products use `lifecycle` tags without a version:
+
+```
+applies_to:
+  serverless:
+    elasticsearch: beta
+    observability: removed
+```
+
 ### Lifecycle and versioning examples
 
 :::::{dropdown} Unversioned products