Merge pull request #81563 from kalexand-rh/main-api-restructure

restructuring API docs

Author: kalexand-rh

_topic_maps/_topic_map.yml

@@ -3475,14 +3475,17 @@ Name: API reference
 Dir: rest_api
 Distros: openshift-enterprise,openshift-origin
 Topics:
-- Name: Understanding API tiers
-  File: understanding-api-support-tiers
-- Name: API compatibility guidelines
-  File: understanding-compatibility-guidelines
-- Name: Editing kubelet log level verbosity and gathering logs
-  File: editing-kubelet-log-level-verbosity
-- Name: API list
-  File: index
+- Name: API overview
+  Dir: overview
+  Topics:
+  - Name: Understanding API tiers
+    File: understanding-api-support-tiers
+  - Name: API compatibility guidelines
+    File: understanding-compatibility-guidelines
+  - Name: Editing kubelet log level verbosity and gathering logs
+    File: editing-kubelet-log-level-verbosity
+  - Name: API list
+    File: index
 - Name: Common object reference
   Dir: objects
   Topics:

getting_started/openshift-overview.adoc

@@ -79,7 +79,7 @@ describes an application that can be deployed using the Helm CLI.
 * **xref:../operators/operator_sdk/osdk-about.adoc#osdk-about[Develop Operators]**: Operators are the preferred method for creating on-cluster applications for {product-title} {product-version}. Learn the workflow for building, testing, and deploying Operators. Then, create your own Operators based on xref:../operators/operator_sdk/ansible/osdk-ansible-support.adoc#osdk-ansible-support[Ansible] or
 xref:../operators/operator_sdk/helm/osdk-helm-support.adoc#osdk-helm-support[Helm], or configure xref:../operators/operator_sdk/osdk-monitoring-prometheus.adoc#osdk-monitoring-prometheus[built-in Prometheus monitoring] using the Operator SDK.
 
-* **xref:../rest_api/index.adoc#api-index[REST API reference]**: Learn about {product-title} application programming interface endpoints.
+* **xref:../rest_api/overview/index.adoc#api-index[REST API reference]**: Learn about {product-title} application programming interface endpoints.
 
 === For administrators
 *  **xref:../architecture/architecture.adoc#architecture-overview-architecture[Understand {product-title} management]**: Learn about components

rest_api/index.adoc

@@ -0,0 +1 @@
+../../_attributes/

rest_api/overview/_attributes

@@ -0,0 +1 @@
+../../images/

rest_api/editing-kubelet-log-level-verbosity.adoc renamed to rest_api/overview/editing-kubelet-log-level-verbosity.adoc

@@ -0,0 +1 @@
+../../modules/

rest_api/overview/images

@@ -0,0 +1 @@
+../../snippets/