docs: document applies_to authoring for settings YAML - #4047
Open
florent-leborgne wants to merge 12 commits into
Open
docs: document applies_to authoring for settings YAML#4047florent-leborgne wants to merge 12 commits into
florent-leborgne wants to merge 12 commits into
Conversation
Settings YAML uses the same keys as body Markdown, but deployment keys are support flags so the Supported on line stays readable. Co-authored-by: Cursor <cursoragent@cursor.com>
Co-authored-by: natasha-moore-elastic <137783811+natasha-moore-elastic@users.noreply.github.com>
A scalar serverless flag over-claims when a setting exists on only one serverless project. Nest elasticsearch, observability, and security when they differ. Co-Authored-By: Cursor Grok 4.6 <noreply@anthropic.com> Co-authored-by: Cursor <cursoragent@cursor.com>
Advanced Settings may exist on only some serverless projects. Nest elasticsearch, observability, or security when that is true. Co-Authored-By: Cursor Grok 4.6 <noreply@anthropic.com> Co-authored-by: Cursor <cursoragent@cursor.com>
Map vectordb, skip workplace_ai, and show previous defaults in a gated note instead of inline description bullets.
florent-leborgne
added
the
documentation
Docs preview (local build)Handbook preview: https://docs-v3-preview.elastic.dev/elastic/docs-builder/pull/4047/ Sample changed pages: |
natasha-moore-elastic
approved these changes
Sep 7, 2026
natasha-moore-elastic
left a comment
natasha-moore-elastic
left a comment
Contributor
There was a problem hiding this comment.
A couple of suggestions for the examples, otherwise LGTM!
Co-authored-by: natasha-moore-elastic <137783811+natasha-moore-elastic@users.noreply.github.com>
Co-authored-by: natasha-moore-elastic <137783811+natasha-moore-elastic@users.noreply.github.com>
The warning was tagged ga 9.2 on a setting that was also ga 9.2, so the gate did not filter anything. Co-authored-by: Cursor <cursoragent@cursor.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Why
Kibana settings YAML files treat
automated_settings.mdas the schema source of truth. That page previously said{settings}YAML follows the sameapplies_torules as page Markdown. Authors then omitted deployment keys or copiedstack: previewontoech.What
Documents the settings-YAML authoring contract.
stackcarries lifecycle and version.ech,ece,eck,self, andserverlessare support flags (gaorunavailable).For Advanced Settings that exist on only some serverless projects, nest
elasticsearch,observability,security, orvectordbunderserverless. Do not nestworkplace_ai. Write a scalarserverless: gaorserverless: unavailablewhen every project matches. Do not mix a scalarserverless:with project keys.Previous defaults go in a gated
note. Use inline{applies_to}in the description for other version-scoped behavior.The syntax example YAML now uses a complete map, including
stack: previewplusech: ga.Supersedes #4014 (fork PR). Same-repo branch so docs preview can create a deployment.
Related: elastic/kibana#288454
Made with Cursor