Merge remote-tracking branch 'upstream/main' into semantic-search-updates

Author: kosabogi

serverless/index-serverless-elasticsearch.asciidoc

@@ -5,6 +5,7 @@
 ++++
 
 include::./pages/what-is-elasticsearch-serverless.asciidoc[leveloffset=+2]
+include::./pages/serverless-differences.asciidoc[leveloffset=+2]
 
 include::./pages/pricing.asciidoc[leveloffset=+2]
 
@@ -42,8 +43,4 @@ include::./pages/search-your-data-semantic-search.asciidoc[leveloffset=+3]
 
 include::./pages/explore-your-data.asciidoc[leveloffset=+2]
 
-include::./pages/search-playground.asciidoc[leveloffset=+2]
-
-include::./pages/serverless-differences.asciidoc[leveloffset=+2]
-
-include::./pages/technical-preview-limitations.asciidoc[leveloffset=+2]
+include::./pages/search-playground.asciidoc[leveloffset=+2]

serverless/pages/action-connectors.asciidoc

@@ -4,8 +4,6 @@
 // :description: Configure connections to third party systems for use in cases and rules.
 // :keywords: serverless
 
-preview:[]
-
 This content applies to: {es-badge} {obs-badge} {sec-badge}
 
 The list of available connectors varies by project type.

serverless/pages/api-keys.asciidoc

@@ -4,8 +4,6 @@
 // :description: API keys allow access to the {stack} on behalf of a user.
 // :keywords: serverless, Elasticsearch, Observability, Security
 
-preview:[]
-
 This content applies to: {es-badge} {obs-badge} {sec-badge}
 
 API keys are security mechanisms used to authenticate and authorize access to {stack} resources,

serverless/pages/apis-elasticsearch-conventions.asciidoc

@@ -4,8 +4,6 @@
 // :description: The {es-serverless} REST APIs have conventions for headers and request bodies.
 // :keywords: serverless, elasticsearch, API, reference
 
-preview:[]
-
 You can run {es} API requests in **{dev-tools-app} → Console**.
 For example:
 

serverless/pages/apis-http-apis.asciidoc

@@ -4,8 +4,33 @@
 // :description: {es} and {kib} expose REST APIs that can be called directly to configure and access {stack} features.
 // :keywords: serverless, elasticsearch, http, rest, overview
 
-preview:[]
+[discrete]
+[[elasticsearch-api-references-links]]
+== API references
 
-* <<elasticsearch-api-conventions>>: The {es-serverless} REST APIs have conventions for headers and request bodies.
-* <<elasticsearch-kibana-api-conventions>>: The Management APIs for {serverless-short} have request header conventions.
-* https://www.elastic.co/docs/api/[API Reference]: Explore the reference information for Elastic Serverless REST APIs
+The following APIs are available for {es-serverless} users.
+These links will take you to the autogenerated API reference documentation.
+
+https://www.elastic.co/docs/api/doc/elasticsearch-serverless[Elasticsearch Serverless APIs →]::
+Use these APIs to index, manage, search, and analyze your data in {es-serverless}.
++
+[TIP]
+====
+Learn how to <<elasticsearch-connecting-to-es-serverless-endpoint,connect to your {es-serverless} endpoint>>.
+====
+
+https://www.elastic.co/docs/api/doc/serverless[Kibana Serverless APIs →]::
+Use these APIs to manage resources such as connectors, data views, and saved objects for your {serverless-full} project.
+
+https://www.elastic.co/docs/api/doc/elastic-cloud-serverless[{serverless-full} APIs →]::
+Use these APIs to manage your {serverless-full} projects.
+
+[discrete]
+[[additional-api-details]]
+== Additional API information
+
+<<elasticsearch-api-conventions>>::
+Reference information about headers and request body conventions for {es-serverless} REST APIs.
+
+<<elasticsearch-kibana-api-conventions>>::
+Reference information about request header conventions for {serverless-full} REST APIs.

serverless/pages/apis-kibana-conventions.asciidoc

@@ -4,8 +4,6 @@
 // :description: The Management APIs for {serverless-short} have request header conventions.
 // :keywords: serverless, kibana, API, reference
 
-preview:[]
-
 The Management REST APIs for {serverless-full} let you manage resources that are available in multiple solutions.
 These resources include connectors, data views, and saved objects.
 If you've previously used the {stack}, the Management APIs are similar to {kib} APIs.

serverless/pages/clients-dot-net-getting-started.asciidoc

@@ -4,8 +4,6 @@
 // :description: Set up and use the .NET client for {es3}.
 // :keywords: serverless, elasticsearch, .net, how to
 
-preview:[]
-
 [NOTE]
 ====
 This client is for use with {es-serverless} only. See also the https://www.elastic.co/guide/en/elasticsearch/client/index.html[{es} clients]. 

serverless/pages/clients-go-getting-started.asciidoc

@@ -4,8 +4,6 @@
 // :description: Set up and use the Go client for {es3}.
 // :keywords: serverless, elasticsearch, go, how to
 
-preview:[]
-
 [NOTE]
 ====
 This client is for use with {es-serverless} only. See also the https://www.elastic.co/guide/en/elasticsearch/client/index.html[{es} clients]. 

serverless/pages/clients-java-getting-started.asciidoc

@@ -4,8 +4,6 @@
 // :description: Set up and use the Java client for {es3}.
 // :keywords: serverless, elasticsearch, java, how to
 
-preview:[]
-
 [NOTE]
 ====
 This client is for use with {es-serverless} only. See also the https://www.elastic.co/guide/en/elasticsearch/client/index.html[{es} clients]. 

serverless/pages/clients-nodejs-getting-started.asciidoc

@@ -4,8 +4,6 @@
 // :description: Set up and use the Node.js client for {es3}.
 // :keywords: serverless, elasticsearch, nodejs, how to
 
-preview:[]
-
 [NOTE]
 ====
 This client is for use with {es-serverless} only. See also the https://www.elastic.co/guide/en/elasticsearch/client/index.html[{es} clients].