Revise content to match new troubleshooting guidelines

[marciw]

Preview

Revise to match new troubleshooting guidelines, mostly to create an example to link to from the guidelines.

• Restructure and add new elements to reflect the new symptom ref content type
• Edit generally for conciseness and clarity

Still under discussion: "symptom" sections

[github-actions]

Documentation preview:

• ✨ Changed pages

[elasticsearchmachine]

Pinging @elastic/es-docs (Team:Docs)

[shainaraskas]

thanks for taking on this first edit!!

some thinkies for you

[shainaraskas]

one thing that is tricky w/ elastic cloud is "Elastic Cloud" products like ECE and ECK behave wildly differently, and we also don't consistently understand Elastic Cloud as an umbrella term. here, "Elastic Cloud" just means serverless + hosted, for example. My impulse is to be hyper-specific until we can better define "Elastic Cloud" as any product that has EC in its name or as anything that lives on "Elastic-managed cloud". that's a long way of saying: consider exploding the EC list

[shainaraskas]

given that this tutorial uses cat thread pool apis it's def not for serverless ... but probably for everything else

[marciw]

I wonder whether there's a case for just saying "All types except serverless" -- seems like that might be the case often enough?

[shainaraskas]

:2c: until we clean up our usage of elastic cloud it's better to be specific (to help later contributors)

[shainaraskas]

(or do me a favor and add it as a comment)

[marciw]

Attempted this. Wonder if we need a canonical list in our guidance/template? (and maybe later some sort of fancy standard table with checkmarks, but later)

[shainaraskas]

yeah I think we need to see how some conversations around that official messaging goes - but agree we should be able to link to a source of truth. afraid of putting this list together now because it is actively being discussed

[marciw]

@shainaraskas TY for the thorough review! I think I've addressed (or skirted) all of your suggestions... at least to the point of "good enough for the purposes of an example"? 🤔

[shainaraskas]

beautiful and delightful to behold! some baby cosmetic thingies, then I think we're ready to link to it in the guidance