Merge pull request #13573 from kalexand-rh/template-stubs

configuration resource stubs

Author: kalexand-rh

modules/configuration-resource-configure.adoc

@@ -0,0 +1,40 @@
+// Module included in the following assemblies:
+//
+// * TBD
+
+
+[id='configuration-resource-configure-{context}']
+= Configure the Configuration Resource
+
+To configure the Configuration Resource, you customize the Custom Resource Definition (CRD) that controls its Operator and deploy it to your cluster.
+
+.Prerequisites
+* Deploy an {product-title} cluster.
+* Review the CRD for the resource and provision any resources that your changes require.
+* Access to the right user to do this thing.
+
+.Procedure
+
+. From some specific computer, modify the CRD for the resource to describe your intended configuration. Save the file in `whatever-the-location-is`.
+
+. Run the following command to update the CRD in your cluster:
++
+[source,bash]
+----
+$ oc something or other --<file> <1> --<cluster><2>
+----
+<1> The CRD file that contains customizations for your resource.
+<2> However you specify the cluster you’re changing.
+
+. Confirm that the resource reflects your changes. Run the following command and review the output:
++
+[source,bash]
+----
+$ oc something or other
+
+Output
+Output
+Output
+----
++
+If the output includes <thing>, the resource redeployed on your cluster.

modules/configuration-resource-overview.adoc

@@ -0,0 +1,51 @@
+// Module included in the following assemblies:
+//
+// * TBD
+
+[id='configuration-resource-overview-{context}']
+= About Configuration Resources in {product-title}
+
+You perform many customization and configuration tasks after you deploy your
+cluster, including configuring networking and setting your identity provider.
+
+In {product-title}, you modify Configuration Resources to determine the behavior
+of these integrations. The Configuration Resources are controlled by Operators
+that are managed by the Cluster Version Operator, which manages all of the
+Operators that run your cluster's control plane.
+
+You can customize the following Configuration Resources:
+
+[cols="3a,8a",options="header"]
+|===
+
+|Configuration Resource |Description
+|Authentication
+|
+
+|DNS
+|
+
+|Image
+|
+
+|Infrastructure
+|
+
+|Ingress
+|
+
+|Network
+|
+
+|OAuth
+|
+
+|===
+
+While you can complete many other customizations and configure other integrations
+with a {product-title} cluster, configuring these resources is a common first
+step after you deploy a cluster.
+
+Like all Operators, the Configuration Resources are governed by
+Custom Resource Definitions (CRD). You customize the CRD for each
+Configuration Resource that you want to modify in your cluster.