Skip to content

Conversation

@shainaraskas
Copy link
Collaborator

@shainaraskas shainaraskas commented Dec 23, 2025

Summary

part of #4117

Fixes applies information on several troubleshooting pages. Did the following additional labor:

  • Restructured some tabbed content: some ECH/self tab splits were actually Kibana/ES API splits. Others were ECE+ECH/ECK+self splits
  • Added some hints around applicability for "shoulder" docs (e.g. discovery is much more automated in ECE/ECH/ECK, but the docs are still helpful)
  • Fixed some linting stuff

Applicability was determined based on supporting documentation (e.g. availability of snapshot/restore plugins) and accessibility of the troubleshooting paths provided. Will get a double-check probably from Edu on my gut feelings

Generative AI disclosure

  1. Did you use a generative AI (GenAI) tool to assist in creating this contribution?
  • Yes
  • No

Confirmed assumptions about troubleshooting applicability with chatgpt

@github-actions
Copy link
Contributor

github-actions bot commented Dec 23, 2025

Vale Linting Results

Summary: 4 suggestions found

💡 Suggestions (4)
File Line Rule Message
troubleshoot/elasticsearch/decrease-disk-usage-data-node.md 29 Elastic.Versions Use 'and later' instead of 'and higher' when referring to versions.
troubleshoot/elasticsearch/diagnose-unassigned-shards.md 138 Elastic.WordChoice Consider using 'cannot' instead of 'unable', unless the term is in the UI.
troubleshoot/elasticsearch/discovery-troubleshooting.md 17 Elastic.WordChoice Consider using 'cannot' instead of 'unable', unless the term is in the UI.
troubleshoot/elasticsearch/discovery-troubleshooting.md 19 Elastic.WordChoice Consider using 'cannot' instead of 'unable', unless the term is in the UI.

@shainaraskas shainaraskas changed the title cleanup pt 1 Applies tag cleanup pt 1 (mostly troubleshooting topics) Dec 29, 2025
@shainaraskas shainaraskas requested a review from eedugon December 29, 2025 15:59
@shainaraskas shainaraskas marked this pull request as ready for review December 29, 2025 15:59
@shainaraskas shainaraskas requested a review from a team as a code owner December 29, 2025 15:59
@shainaraskas
Copy link
Collaborator Author

@eedugon hoping you can do a gut check on my changes and see if you think I've recategorized any of these incorrectly

Copy link
Contributor

@eedugon eedugon left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks great!

I shared some comments that you can ignore if you feel unneeded. More over the comments that suggest changes on the troubleshooting procedure itself which might not be the objective of this PR :)

btw, are you planning to fix the applies tags of https://www.elastic.co/docs/troubleshoot/elasticsearch/troubleshooting-unstable-cluster and its siblings in a different PR?

I think those would also need to remove deployment types and keep stack only.

@shainaraskas shainaraskas merged commit 689c2ab into main Dec 30, 2025
8 checks passed
@shainaraskas shainaraskas deleted the tag-cleanup-sr-dec branch December 30, 2025 16:27
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants