Cleanup search connectors, add some reference -> docs content signposts in various sections

leemthompo · leemthompo · commit 81a87852cf0f · 2025-02-28T17:55:28.000+01:00
diff --git a/docs/reference/data-analysis/text-analysis/index.md b/docs/reference/data-analysis/text-analysis/index.md
@@ -2,6 +2,12 @@
 
 % TO-DO: Add links to "Data analysis basics"%
 
+:::{note}
+This section provides detailed **reference information**.
+
+Refer to [the text analysis overview](docs-content://manage-data/data-store/text-analysis.md) in the **Manage data** section for overview and conceptual information.
+:::
+
 This section contains reference information for text analysis components features, including:
 
 * [Analyzers](/reference/data-analysis/text-analysis/analyzer-reference.md)
diff --git a/docs/reference/ingestion-tools/search-connectors/api-tutorial.md b/docs/reference/ingestion-tools/search-connectors/api-tutorial.md
@@ -1,5 +1,9 @@
 ---
 navigation_title: "API tutorial"
+applies_to:
+  stack: ga
+  serverless: 
+    elasticsearch: ga
 mapped_pages:
   - https://www.elastic.co/guide/en/elasticsearch/reference/current/es-connectors-tutorial-api.html
 ---
diff --git a/docs/reference/ingestion-tools/search-connectors/connector-reference.md b/docs/reference/ingestion-tools/search-connectors/connector-reference.md
@@ -1,4 +1,7 @@
 ---
+applies_to:
+  stack: ga
+  serverless: ga
 mapped_pages:
   - https://www.elastic.co/guide/en/elasticsearch/reference/current/es-connectors-refs.html
 ---
diff --git a/docs/reference/ingestion-tools/search-connectors/connectors-ui-in-kibana.md b/docs/reference/ingestion-tools/search-connectors/connectors-ui-in-kibana.md
@@ -1,13 +1,17 @@
 ---
+applies_to:
+  stack: ga
+  serverless: 
+    elasticsearch: ga
 mapped_pages:
-  - https://www.elastic.co/guide/en/elasticsearch/reference/current/es-connectors-usage.html
+- https://www.elastic.co/guide/en/elasticsearch/reference/current/es-connectors-usage.html
 ---
 
-# Connectors UI in Kibana [es-connectors-usage]
+# Connectors UI [es-connectors-usage]
 
 This document describes operations available to connectors using the UI.
 
-In the Kibana UI, navigate to **Search > Content > Connectors** from the main menu, or use the [global search field](docs-content://explore-analyze/query-filter/filtering.md#_finding_your_apps_and_objects). Here, you can view a summary of all your connectors and sync jobs, and to create new connectors.
+In the Kibana or Serverless UI, find Connectors using the [global search field](docs-content://explore-analyze/query-filter/filtering.md#_finding_your_apps_and_objects). Here, you can view a summary of all your connectors and sync jobs, and to create new connectors.
 
 ::::{tip}
 In 8.12 we introduced a set of [Connector APIs](https://www.elastic.co/docs/api/doc/elasticsearch/group/endpoint-connector) to create and manage Elastic connectors and sync jobs, along with a [CLI tool](https://github.com/elastic/connectors/blob/main/docs/CLI.md). Use these tools if you’d like to work with connectors and sync jobs programmatically, without using the UI.
diff --git a/docs/reference/ingestion-tools/search-connectors/elastic-managed-connectors.md b/docs/reference/ingestion-tools/search-connectors/elastic-managed-connectors.md
@@ -1,4 +1,6 @@
 ---
+applies_to:
+  ess: discontinued 9.0.0
 mapped_pages:
   - https://www.elastic.co/guide/en/elasticsearch/reference/current/es-native-connectors.html
 ---
diff --git a/docs/reference/ingestion-tools/search-connectors/es-connectors-apis.md b/docs/reference/ingestion-tools/search-connectors/es-connectors-apis.md
@@ -1,4 +1,8 @@
 ---
+applies_to:
+  stack: ga
+  serverless: 
+    elasticsearch: ga
 mapped_pages:
   - https://www.elastic.co/guide/en/elasticsearch/reference/current/es-connectors-apis.html
 ---
diff --git a/docs/reference/ingestion-tools/search-connectors/es-connectors-overview-architecture.md b/docs/reference/ingestion-tools/search-connectors/es-connectors-overview-architecture.md
@@ -10,24 +10,9 @@ mapped_pages:
 The following section provides a high-level overview of common architecture approaches for the internal knowledge search use case (AKA workplace search).
 
 
-## Hybrid architecture [es-connectors-overview-architecture-hybrid]
+$$$es-connectors-overview-architecture-hybrid$$$
 
-Data is synced to an Elastic Cloud deployment through managed connectors and/or self-managed connectors. A self-managed search application exposes the relevant data that your end users are authorized to see in a search experience.
-
-Summary:
-
-* The best combination in terms of flexibility and out-of-the box functionality
-* Integrates with Elastic Cloud hosted managed connectors to bring data to Elasticsearch with minimal operational overhead
-* Self-managed connectors allow enterprises to adhere to strict access policies when using firewalls that don’t allow incoming connections to data sources, while outgoing traffic is easier to control
-* Provides additional functionality available for self-managed connectors such as the [Extraction Service](/reference/ingestion-tools/search-connectors/es-connectors-content-extraction.md#es-connectors-content-extraction-local)
-* Basic functionality available for Standard licenses, advanced features for Platinum licenses
-
-The following diagram provides a high-level overview of the hybrid internal knowledge search architecture.
-
-:::{image} ../../../images/hybrid-architecture.png
-:alt: hybrid architecture
-:class: screenshot
-:::
+% ^^ discontinued 9.0.0
 
 
 ## Self-managed architecture [es-connectors-overview-architecture-self-managed]
diff --git a/docs/reference/ingestion-tools/search-connectors/es-connectors-run-from-docker.md b/docs/reference/ingestion-tools/search-connectors/es-connectors-run-from-docker.md
@@ -43,7 +43,7 @@ elasticsearch.api_key: <ELASTICSEARCH_API_KEY>
 connectors:
   -
     connector_id: <CONNECTOR_ID_FROM_KIBANA>
-    service_type: Zoom # sharepoint_online (example)
+    service_type: sharepoint_online # Example value — update this for service type you are connecting to
     api_key: <CONNECTOR_API_KEY_FROM_KIBANA> # Optional. If not provided, the connector will use the elasticsearch.api_key instead
 ```
 
diff --git a/docs/reference/ingestion-tools/search-connectors/index.md b/docs/reference/ingestion-tools/search-connectors/index.md
@@ -1,4 +1,7 @@
 ---
+applies_to:
+  stack: ga
+  serverless: ga
 mapped_pages:
   - https://www.elastic.co/guide/en/elasticsearch/reference/current/es-connectors.html
   - https://www.elastic.co/guide/en/serverless/current/elasticsearch-ingest-data-through-integrations-connector-client.html
diff --git a/docs/reference/ingestion-tools/search-connectors/self-managed-connectors.md b/docs/reference/ingestion-tools/search-connectors/self-managed-connectors.md
@@ -1,4 +1,7 @@
 ---
+applies_to:
+  stack: ga
+  serverless: ga
 mapped_pages:
   - https://www.elastic.co/guide/en/elasticsearch/reference/current/es-build-connector.html
 ---
diff --git a/docs/reference/scripting-languages/index.md b/docs/reference/scripting-languages/index.md
@@ -1,5 +1,7 @@
 # Scripting languages
 
-This section contains the Painless scripting language reference.
+:::{note}
+This section provides detailed **reference information** about the the Painless scripting language.
 
-For an overview of scripting languages in {{es}}, go to [Scripting](docs-content://explore-analyze/scripting.md).
+Refer to the [scripting languages overview](docs-content://explore-analyze/scripting.md) in the **Explore and analyze** section for an overview of available scripting languages in {{es}}.
+:::

Original file line number	Diff line number	Diff line change
`@@ -43,7 +43,7 @@ elasticsearch.api_key: <ELASTICSEARCH_API_KEY>`
`43`	`43`	`connectors:`
`44`	`44`	`-`
`45`	`45`	`connector_id: <CONNECTOR_ID_FROM_KIBANA>`
`46`		`- service_type: Zoom # sharepoint_online (example)`
	`46`	`+ service_type: sharepoint_online # Example value — update this for service type you are connecting to`
`47`	`47`	`api_key: <CONNECTOR_API_KEY_FROM_KIBANA> # Optional. If not provided, the connector will use the elasticsearch.api_key instead`
`48`	`48`	```
`49`	`49`