[Do not merge] Convert tabs that can be applies-switch #4429

florent-leborgne · 2025-12-19T14:35:46Z

Summary

This PR converts tabs that should now be applies-switch thanks to the recent and upcoming updates to the metadata system.

This PR should only be merged after elastic/docs-builder#2322 is merged.

CI should fail until then.

Contributes to: #4361

Generative AI disclosure

Did you use a generative AI (GenAI) tool to assist in creating this contribution?

Yes
No

github-actions · 2025-12-19T14:37:08Z

Vale Linting Results

Summary: 2 warnings, 38 suggestions found

⚠️ Warnings (2)

File	Line	Rule	Message
troubleshoot/elasticsearch/troubleshoot-migrate-to-tiers.md	29	Elastic.BritishSpellings	Use American English spelling 'toward' instead of British English 'towards'.
troubleshoot/elasticsearch/troubleshoot-migrate-to-tiers.md	116	Elastic.BritishSpellings	Use American English spelling 'toward' instead of British English 'towards'.

💡 Suggestions (38)

File	Line	Rule	Message
deploy-manage/users-roles/cluster-or-deployment-auth/saml.md	425	Elastic.Acronyms	'PEM' has no definition.
troubleshoot/elasticsearch/add-tier.md	29	Elastic.Wordiness	Consider using 'to' instead of 'In order to'.
troubleshoot/elasticsearch/add-tier.md	74	Elastic.Wordiness	Consider using 'to' instead of 'In order to'.
troubleshoot/elasticsearch/allow-all-cluster-allocation.md	27	Elastic.Wordiness	Consider using 'to' instead of 'In order to'.
troubleshoot/elasticsearch/allow-all-cluster-allocation.md	81	Elastic.Wordiness	Consider using 'to' instead of 'In order to'.
troubleshoot/elasticsearch/allow-all-index-allocation.md	30	Elastic.Wordiness	Consider using 'to' instead of 'In order to'.
troubleshoot/elasticsearch/allow-all-index-allocation.md	83	Elastic.Wordiness	Consider using 'to' instead of 'In order to'.
troubleshoot/elasticsearch/decrease-disk-usage-data-node.md	55	Elastic.Wordiness	Consider using 'to' instead of 'In order to'.
troubleshoot/elasticsearch/diagnose-unassigned-shards.md	30	Elastic.Wordiness	Consider using 'to' instead of 'In order to'.
troubleshoot/elasticsearch/diagnose-unassigned-shards.md	146	Elastic.Wordiness	Consider using 'to' instead of 'In order to'.
troubleshoot/elasticsearch/diagnosing-corrupted-repositories.md	23	Elastic.FutureTense	'will entail' might be in future tense. Write in the present tense to describe the state of the product as it is now.
troubleshoot/elasticsearch/diagnosing-corrupted-repositories.md	23	Elastic.FutureTense	'will keep' might be in future tense. Write in the present tense to describe the state of the product as it is now.
troubleshoot/elasticsearch/diagnosing-corrupted-repositories.md	23	Elastic.FutureTense	'will be' might be in future tense. Write in the present tense to describe the state of the product as it is now.
troubleshoot/elasticsearch/diagnosing-corrupted-repositories.md	60	Elastic.FutureTense	'will entail' might be in future tense. Write in the present tense to describe the state of the product as it is now.
troubleshoot/elasticsearch/fix-other-node-out-of-disk.md	38	Elastic.Wordiness	Consider using 'to' instead of 'In order to'.
troubleshoot/elasticsearch/fix-other-node-out-of-disk.md	38	Elastic.FutureTense	'will need' might be in future tense. Write in the present tense to describe the state of the product as it is now.
troubleshoot/elasticsearch/high-jvm-memory-pressure.md	45	Elastic.Acronyms	'JVM' has no definition.
troubleshoot/elasticsearch/increase-capacity-data-node.md	21	Elastic.Wordiness	Consider using 'to' instead of 'In order to'.
troubleshoot/elasticsearch/increase-capacity-data-node.md	57	Elastic.Wordiness	Consider using 'to' instead of 'In order to'.
troubleshoot/elasticsearch/increase-capacity-data-node.md	57	Elastic.FutureTense	'will need' might be in future tense. Write in the present tense to describe the state of the product as it is now.
troubleshoot/elasticsearch/increase-cluster-shard-limit.md	29	Elastic.Wordiness	Consider using 'to' instead of 'In order to'.
troubleshoot/elasticsearch/increase-cluster-shard-limit.md	81	Elastic.Wordiness	Consider using 'to' instead of 'In order to'.
troubleshoot/elasticsearch/increase-shard-limit.md	29	Elastic.Wordiness	Consider using 'to' instead of 'In order to'.
troubleshoot/elasticsearch/increase-shard-limit.md	82	Elastic.Wordiness	Consider using 'to' instead of 'In order to'.
troubleshoot/elasticsearch/increase-tier-capacity.md	27	Elastic.FutureTense	'will increase' might be in future tense. Write in the present tense to describe the state of the product as it is now.
troubleshoot/elasticsearch/increase-tier-capacity.md	139	Elastic.Wordiness	Consider using 'to' instead of 'In order to'.
troubleshoot/elasticsearch/repeated-snapshot-failures.md	27	Elastic.Wordiness	Consider using 'to' instead of 'In order to'.
troubleshoot/elasticsearch/restore-from-snapshot.md	27	Elastic.Wordiness	Consider using 'to' instead of 'In order to'.
troubleshoot/elasticsearch/restore-from-snapshot.md	231	Elastic.Wordiness	Consider using 'to' instead of 'In order to'.
troubleshoot/elasticsearch/troubleshoot-migrate-to-tiers.md	29	Elastic.Wordiness	Consider using 'to' instead of 'In order to'.
troubleshoot/elasticsearch/troubleshoot-migrate-to-tiers.md	29	Elastic.FutureTense	'will resolve' might be in future tense. Write in the present tense to describe the state of the product as it is now.
troubleshoot/elasticsearch/troubleshoot-migrate-to-tiers.md	29	Elastic.FutureTense	'will also' might be in future tense. Write in the present tense to describe the state of the product as it is now.
troubleshoot/elasticsearch/troubleshoot-migrate-to-tiers.md	116	Elastic.Wordiness	Consider using 'to' instead of 'In order to'.
troubleshoot/elasticsearch/troubleshoot-migrate-to-tiers.md	116	Elastic.FutureTense	'will resolve' might be in future tense. Write in the present tense to describe the state of the product as it is now.
troubleshoot/elasticsearch/troubleshoot-migrate-to-tiers.md	116	Elastic.FutureTense	'will also' might be in future tense. Write in the present tense to describe the state of the product as it is now.
troubleshoot/observability/apm/apm-server-response-codes.md	20	Elastic.WordChoice	Consider using 'refer to (if it's a document), view (if it's a UI element)' instead of 'See', unless the term is in the UI.
troubleshoot/observability/apm/apm-server-response-codes.md	24	Elastic.WordChoice	Consider using 'refer to (if it's a document), view (if it's a UI element)' instead of 'See', unless the term is in the UI.
troubleshoot/observability/troubleshoot-logs.md	49	Elastic.WordChoice	Consider using 'refer to (if it's a document), view (if it's a UI element)' instead of 'see', unless the term is in the UI.

florent-leborgne · 2025-12-19T16:22:37Z

~~I broke something in there which isn't obvious to find, 🕵️~~

Edit: found ittttt

…-leborgne/docs-content into convert-tabs-into-applies-switch

github-actions · 2025-12-19T17:59:06Z

🔍 Preview links for changed docs

More links …

benironside · 2025-12-19T23:12:31Z

@florent-leborgne , what kind of reviews do you want on this? It's not the typical PR so I'm just thinking about how best to go about it 🕵️

shainaraskas

most of this looks good, but please skip the elasticsearch troubleshooting content. I'll need to fix it with the page-level issues

shainaraskas · 2025-12-22T18:14:33Z

deploy-manage/autoscaling/trained-model-autoscaling.md

 #### Adaptive resources disabled

-::::{tab-set}
+::::{applies-switch}

-:::{tab-item} ECH, ECE
+:::{applies-item} { ess:, ece: }


I think a one-tab applies switch is an anti-pattern. this should be a tag on the section instead.

shainaraskas · 2025-12-22T18:17:30Z

deploy-manage/manage-spaces.md

+* {applies_to}`serverless:` [Spaces API](https://www.elastic.co/docs/api/doc/serverless/operation/operation-get-spaces-space)
+* {applies_to}`stack:` [Spaces API](https://www.elastic.co/docs/api/doc/kibana/operation/operation-post-spaces-copy-saved-objects)


I don't think this is a good case for applies tags because it's harder to read

shainaraskas · 2025-12-22T18:21:25Z

deploy-manage/security/network-security-api.md


-::::{tab-set}
-:group: ech-serverless-ece
+::::{applies-switch}


do these need to be ordered manually? we might want serverless here first

shainaraskas · 2025-12-22T18:24:10Z

deploy-manage/security/private-connectivity-gcp.md

+:::{applies-item} serverless:
+
 1. Find your project on the home page or on the **Serverless projects** page, then select **Manage** to access its settings menus.

    On the **Hosted deployments** page you can narrow your deployments by name, ID, or choose from several other filters. To customize your view, use a combination of filters, or change the format from a grid to a list.
 2. On the **Network security** page, find the policy that you want to disconnect. 
 3. Under **Actions**, click the **Delete** icon.
 :::


this section being here is actually a bug. gonna have to remove it in another PR

shainaraskas · 2025-12-22T18:48:11Z

deploy-manage/users-roles/cluster-or-deployment-auth/saml.md

 deployment:
  self:
  eck:
 ```


while you're here, can you fix this? applies tag is just floating in midair

shainaraskas · 2025-12-22T19:02:30Z

get-started/evaluate-elastic.md

 Once you know what you want to evaluate, choose the deployment option that best supports your goals. Elastic offers two primary deployment options on {{ecloud}}.

-::::{tab-set}
+::::{applies-switch}


don't like that this is tabbed but 🤷

shainaraskas · 2025-12-22T19:14:33Z

manage-data/use-case-use-elasticsearch-to-manage-time-series-data.md

 ::::::

-::::::{tab-item} Self-managed
+::::::{applies-item} self:


I think this is a case where self-managed is used as shorthand for ece eck self ... I can't be sure about this because I don't know how ECE handles this. maybe we need an issue to double-check this

shainaraskas · 2025-12-22T19:15:50Z

troubleshoot/elasticsearch/add-tier.md

 In order to allow indices to be allocated, follow these steps to add the [data tier](../../manage-data/lifecycle/data-tiers.md) the indices expect to be allocated on to your deployment:

-:::::::{tab-set}
+:::::::{applies-switch}


this one also feels wrong. consider leaving it alone

shainaraskas · 2025-12-22T19:16:38Z

troubleshoot/elasticsearch/allow-all-cluster-allocation.md

 In order to (re)allow all data to be allocated follow these steps:

-:::::::{tab-set}
+:::::::{applies-switch}


same with this one ... bet a lot of the troubleshooting ones will have this problem

shainaraskas · 2025-12-22T19:18:05Z

as a side note, there's only maybe a handful of things in here with a range ... this could be split and most of it could be merged ASAP

florent-leborgne added 2 commits December 19, 2025 15:32

convert some tabs into applies-switch

42d194f

typo

cbde482

florent-leborgne requested review from a team as code owners December 19, 2025 14:35

florent-leborgne mentioned this pull request Dec 19, 2025

Adjust applies_to tags for the new syntax and semantics #4361

Open

github-actions bot had a problem deploying to docs-preview December 19, 2025 14:36 Failure

Merge branch 'main' into convert-tabs-into-applies-switch

dd13a1a

github-actions bot had a problem deploying to docs-preview December 19, 2025 14:43 Failure

fixes

c9689e7

github-actions bot had a problem deploying to docs-preview December 19, 2025 17:25 Failure

simplify

d435b94

github-actions bot had a problem deploying to docs-preview December 19, 2025 17:38 Failure

fix

95af9b4

github-actions bot had a problem deploying to docs-preview December 19, 2025 17:45 Failure

the right fixes

3837b66

github-actions bot had a problem deploying to docs-preview December 19, 2025 17:53 Failure

Merge branch 'main' into convert-tabs-into-applies-switch

ca36768

github-actions bot had a problem deploying to docs-preview December 19, 2025 17:55 Failure

florent-leborgne added 2 commits December 19, 2025 18:56

another missed one

80a0851

Merge branch 'convert-tabs-into-applies-switch' of github.com:florent…

187086e

…-leborgne/docs-content into convert-tabs-into-applies-switch

github-actions bot deployed to docs-preview December 19, 2025 17:57 View deployment

benironside mentioned this pull request Dec 19, 2025

[do not merge] check multi value applies-to and lists #4431

Open

2 tasks

shainaraskas reviewed Dec 22, 2025

View reviewed changes

		* {applies_to}`serverless:` [Spaces API](https://www.elastic.co/docs/api/doc/serverless/operation/operation-get-spaces-space)
		* {applies_to}`stack:` [Spaces API](https://www.elastic.co/docs/api/doc/kibana/operation/operation-post-spaces-copy-saved-objects)

[Do not merge] Convert tabs that can be applies-switch #4429

Are you sure you want to change the base?

[Do not merge] Convert tabs that can be applies-switch #4429

Uh oh!

Conversation

florent-leborgne commented Dec 19, 2025

Summary

Generative AI disclosure

Uh oh!

github-actions bot commented Dec 19, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Vale Linting Results

Uh oh!

florent-leborgne commented Dec 19, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions bot commented Dec 19, 2025

🔍 Preview links for changed docs

Uh oh!

benironside commented Dec 19, 2025

Uh oh!

shainaraskas left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

shainaraskas commented Dec 22, 2025

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

github-actions bot commented Dec 19, 2025 •

edited

Loading

florent-leborgne commented Dec 19, 2025 •

edited

Loading