Add Troubleshooting entry point

raw-migrated-files/toc.yml

@@ -553,5 +553,3 @@ toc:
   - file: tech-content/starting-with-the-elasticsearch-platform-and-its-solutions/index.md
     children:
       - file: tech-content/starting-with-the-elasticsearch-platform-and-its-solutions/get-elastic.md
-      - file: tech-content/starting-with-the-elasticsearch-platform-and-its-solutions/get-support-help.md
-      - file: tech-content/starting-with-the-elasticsearch-platform-and-its-solutions/troubleshooting-and-faqs.md

troubleshoot/index.md

@@ -6,47 +6,78 @@ mapped_urls:
   - https://www.elastic.co/guide/en/cloud/current/ec-get-help.html
 ---
 
-# Troubleshoot
+# Troubleshooting
+
+
+% Scope notes: - Match new content type; TOC entry TBD - consider splitting out subsections?
+
+% see https://docs.elastic.dev/content-architecture/content-type/troubleshooting/entrypoint
+
+% TODO pull in product-specific tips etc. from other TS sections
 
-% What needs to be done: Refine
 
 :::{admonition} WIP
 ⚠️ **This section is a work in progress.** ⚠️
 
-The documentation team is actively working on structure, user focus, and more.
+The documentation team is actively working on the pages in this section.
 :::
 
-Use the topics in this section to troubleshoot Elastic products, features, and deployments.
-
+This section contains information about resolving common issues you might encounter with Elastic products, as well as troubleshooting resources and guidance.
 
-* [](/troubleshoot/elasticsearch/elasticsearch.md)
-* [](/troubleshoot/kibana.md)
-* [](/troubleshoot/observability.md)
-* [](/troubleshoot/security.md)
-* [](/troubleshoot/ingest.md)
-* [](/troubleshoot/deployments/elastic-cloud.md)
-* [](/troubleshoot/deployments/cloud-enterprise/cloud-enterprise.md)
-* [](/troubleshoot/deployments/cloud-on-k8s/kubernetes.md)
+If you can't find your issue here, explore the [additional resources](#troubleshoot-additional-resources) or [contact us](#contact-us).
 
+:::{note} 
+You might need to review the troubleshooting content for more than one product or topic area. In most Elastic deployments, you use multiple components from the [Elastic Stack](/get-started/the-stack.md), plus software to orchestrate your deployment. Because these components communicate with each other, you might see errors in one product that originate from another part of the stack, or from your deployment infrastructure. 
+:::
 
-## Contact us [contact-us]
+* [{{es}}](/troubleshoot/elasticsearch/elasticsearch.md)
+* [{{kib}}](/troubleshoot/kibana.md)
+* [Elastic {{observability}}](/troubleshoot/observability.md)
+* [{{elastic-sec}}](/troubleshoot/security.md)
+* [Ingest tools](/troubleshoot/ingest.md)
+* [{{ecloud}}](/troubleshoot/deployments/elastic-cloud.md)
+* [{{ece}}](/troubleshoot/deployments/cloud-enterprise/cloud-enterprise.md)
+* [{{eck}}](/troubleshoot/deployments/cloud-on-k8s/kubernetes.md)
 
-:::{warning}
+## Error reference 
+:::{admonition} WIP
 Work in progress
 :::
 
-% Scope notes: - Match new content type; TOC entry TBD - consider splitting out subsections?
+## Additional resources [troubleshoot-additional-resources]
 
-% Use migrated content from existing pages that map to this page:
+* Find additional troubleshooting articles in the [Elastic Support Portal](https://support.elastic.co/).
 
-% - [ ] ./raw-migrated-files/tech-content/starting-with-the-elasticsearch-platform-and-its-solutions/get-support-help.md
-% - [ ] ./raw-migrated-files/tech-content/starting-with-the-elasticsearch-platform-and-its-solutions/troubleshooting-and-faqs.md
-% - next one added by marciw manually for tracking
-% - [ ] ./raw-migrated-files/cloud/cloud/ec-get-help.md (especially IDs -- no generated list because page was incorrectly mapped to a new v3 page instead of as a many-to-one for this page)
+  You can access the Support Portal using your {{ecloud}} account. {{ecloud}} accounts are free and do not require an active subscription.
 
-% WIP sections added by marciw
-% see https://docs.elastic.dev/content-architecture/content-type/troubleshooting/entrypoint
-% ## one for each grouping
-% ## Additional resources [troubleshoot-additional-resources]
-% ## Contact us [troubleshoot-contact-us]
-% ### Working with support 
+* Visit the [Elastic community forums](https://discuss.elastic.co) to get answers from experts in the community, including Elastic team members.
+
+* Use the top search bar to search all our docs for your issue. Some troubleshooting content is contained in other sections of the Elastic documentation.
+
+
+## Contact us [contact-us]
+
+If you have an [Elastic subscription](https://www.elastic.co/pricing), you can contact Elastic support for assistance. You can reach us in the following ways: 
+
+* **Through the [Elastic Support Portal](https://support.elastic.co/):** The Elastic Support Portal is the central place where you can access all of your cases, subscriptions, and licenses. Within a few hours after subscribing, you receive an email with instructions on how to log in to the Support Portal, where you can track both current and archived cases.
+
+  You can access the portal [directly](https://support.elastic.co/) or by clicking the life preserver icon on any Elastic Cloud page.
+
+
+* **By email:** [[email protected]](mailto:[email protected])
+
+  :::{tip}
+  If you contact us by email, use the email address you registered with so we can help you more quickly. If you are using a distribution list as your registered email, you can also register a second email address with us. Just open a case to let us know the name and email address you want to add.
+  :::
+
+## Working with support [troubleshoot-work-with-support]
+
+Try these tips when opening a support case:
+
+* Include the deployment ID that you want help with, especially if you have several deployments. 
+
+  You can find the deployment ID on the overview page for your cluster in the {{ecloud}} Console.
+
+* Describe the problem. Include any relevant details, including error messages you encountered, dates and times when the problem occurred, or anything else you think might be helpful.
+
+* Upload any pertinent files.

troubleshoot/observability/amazon-data-firehose.md

@@ -23,5 +23,5 @@ There are several facets to optimizing the underlying Elasticsearch performance,
 
 ## Support [aws-firehose-troubleshooting-support]
 
-If you encounter further problems, please contact [Elastic support](https://www.elastic.co/guide/en/starting-with-the-elasticsearch-platform-and-its-solutions/current/get-support-help.html).
+If you encounter further problems, please [contact us]](/troubleshoot/index.md#contact-us).