Merge pull request #31403 from bergerhoffer/OSDOCS-1790

OSDOCS-1790: Adding auto generated CLI output

Author: bergerhoffer

_topic_map.yml

@@ -509,9 +509,9 @@ Topics:
   - Name: Extending the OpenShift CLI with plug-ins
     File: extending-cli-plugins
     Distros: openshift-enterprise,openshift-origin
-  - Name: OpenShift CLI developer commands
+  - Name: OpenShift CLI developer command reference
     File: developer-cli-commands
-  - Name: OpenShift CLI administrator commands
+  - Name: OpenShift CLI administrator command reference
     File: administrator-cli-commands
     Distros: openshift-enterprise,openshift-origin
   - Name: Usage of oc and kubectl commands

cli_reference/openshift_cli/administrator-cli-commands.adoc

@@ -1,24 +1,19 @@
 [id="cli-administrator-commands"]
-= OpenShift CLI administrator commands
+= OpenShift CLI administrator command reference
 include::modules/common-attributes.adoc[]
 :context: cli-administrator-commands
 
 toc::[]
 
-// Cluster management CLI commands
-include::modules/cli-administrator-cluster-management.adoc[leveloffset=+1]
+This reference provides descriptions and example commands for OpenShift CLI (`oc`) administrator commands. For developer commands, see the xref:../../cli_reference/openshift_cli/developer-cli-commands.adoc#cli-developer-commands[OpenShift CLI developer command reference].
 
-// Node management CLI commands
-include::modules/cli-administrator-node-management.adoc[leveloffset=+1]
+Run `oc adm help` to list all administrator commands or run `oc <command> --help` to get additional details for a specific command.
 
-// Security and policy CLI commands
-include::modules/cli-administrator-security-policy.adoc[leveloffset=+1]
+// The following file is auto-generated from the openshift/oc repository
+// OpenShift CLI (oc) administrator commands
+include::modules/oc-adm-by-example-content.adoc[leveloffset=+1]
 
-// Maintenance CLI commands
-include::modules/cli-administrator-maintenance.adoc[leveloffset=+1]
+[id="additional-resources_cli-administrator-commands"]
+== Additional resources
 
-// Configuration CLI commands
-include::modules/cli-administrator-configuration.adoc[leveloffset=+1]
-
-// Other administrator CLI commands
-include::modules/cli-administrator-other.adoc[leveloffset=+1]
+* xref:../../cli_reference/openshift_cli/developer-cli-commands.adoc#cli-developer-commands[OpenShift CLI developer command reference]

cli_reference/openshift_cli/developer-cli-commands.adoc

@@ -1,27 +1,26 @@
 [id="cli-developer-commands"]
-= OpenShift CLI developer commands
+= OpenShift CLI developer command reference
 include::modules/common-attributes.adoc[]
 :context: cli-developer-commands
 
 toc::[]
 
-// Basic CLI commands
-include::modules/cli-developer-basic.adoc[leveloffset=+1]
+This reference provides descriptions and example commands for OpenShift CLI (`oc`) developer commands.
+ifdef::openshift-enterprise,openshift-origin[]
+For administrator commands, see the xref:../../cli_reference/openshift_cli/administrator-cli-commands.adoc#cli-administrator-commands[OpenShift CLI administrator command reference].
+endif::openshift-enterprise,openshift-origin[]
 
-// Build and deploy CLI commands
-include::modules/cli-developer-build-deploy.adoc[leveloffset=+1]
+Run `oc help` to list all commands or run `oc <command> --help` to get additional details for a specific command.
 
-// Application management CLI commands
-include::modules/cli-developer-application-management.adoc[leveloffset=+1]
+// The following file is auto-generated from the openshift/oc repository
+// OpenShift CLI (oc) developer commands
+include::modules/oc-by-example-content.adoc[leveloffset=+1]
 
-// Troubleshooting and debugging CLI commands
-include::modules/cli-developer-troubleshooting.adoc[leveloffset=+1]
+ifdef::openshift-enterprise,openshift-origin[]
 
-// Advanced developer CLI commands
-include::modules/cli-developer-advanced.adoc[leveloffset=+1]
+[id="additional-resources_cli-developer-commands"]
+== Additional resources
 
-// Settings CLI commands
-include::modules/cli-developer-settings.adoc[leveloffset=+1]
+* xref:../../cli_reference/openshift_cli/administrator-cli-commands.adoc#cli-administrator-commands[OpenShift CLI administrator command reference]
 
-// Other developer CLI commands
-include::modules/cli-developer-other.adoc[leveloffset=+1]
+endif::openshift-enterprise,openshift-origin[]