Merge pull request #32388 from Preeticp/crd_format

crd formatting for release notes and all assembly stubs

Author: Preeticp

cicd/pipelines/creating-applications-with-cicd-pipelines.adoc

@@ -29,7 +29,7 @@ This section uses the `pipelines-tutorial` example to demonstrate the preceding
 * You have access to an {product-title} cluster.
 * You have installed xref:../../cicd/pipelines/installing-pipelines.adoc#installing-pipelines[OpenShift Pipelines] using the {pipelines-title} Operator listed in the OpenShift OperatorHub. Once installed, it is applicable to the entire cluster.
 * You have installed xref:../../cli_reference/tkn_cli/installing-tkn.adoc#installing-tkn[OpenShift Pipelines CLI].
-* You have forked the front-end link:https://github.com/openshift/pipelines-vote-ui/tree/{pipelines-ver}[`pipelines-vote-ui`] and back-end link:https://github.com/openshift/pipelines-vote-api/tree/{pipelines-ver}[`pipelines-vote-api`] Git repositories using your GitHub ID, and have Administrator access to these repositories.
+* You have forked the front-end link:https://github.com/openshift/pipelines-vote-ui/tree/{pipelines-ver}[`pipelines-vote-ui`] and back-end link:https://github.com/openshift/pipelines-vote-api/tree/{pipelines-ver}[`pipelines-vote-api`] Git repositories using your GitHub ID, and have administrator access to these repositories.
 * Optional: You have cloned the link:https://github.com/openshift/pipelines-tutorial/tree/{pipelines-ver}[`pipelines-tutorial`] Git repository.
 
 
@@ -60,7 +60,7 @@ include::modules/op-triggering-a-pipelinerun.adoc[leveloffset=+1]
 [id="pipeline-addtl-resources"]
 == Additional resources
 
-* For more details on pipelines in the *Developer* perspective, see the xref:../../cicd/pipelines/working-with-pipelines-using-the-developer-perspective.adoc#working-with-pipelines-using-the-developer-perspective[working with Pipelines in the *Developer* perspective] section.
+* For more details on pipelines in the *Developer* perspective, see the xref:../../cicd/pipelines/working-with-pipelines-using-the-developer-perspective.adoc#working-with-pipelines-using-the-developer-perspective[working with pipelines in the *Developer* perspective] section.
 * To learn more about Security Context Constraints (SCCs), see the xref:../../authentication/managing-security-context-constraints.adoc#managing-pod-security-policies[Managing Security Context Constraints] section.
 * For more examples of reusable tasks, see the link:https://github.com/openshift/pipelines-catalog[OpenShift Catalog] repository. Additionally, you can also see the Tekton Catalog in the Tekton project.
 * For more details on re-encrypt TLS termination, see link:https://docs.openshift.com/container-platform/3.11/architecture/networking/routes.html#re-encryption-termination[Re-encryption Termination].

cicd/pipelines/installing-pipelines.adoc

@@ -24,11 +24,11 @@ If you have the pull secret, add the `redhat-operators` catalog to the OperatorH
 endif::[]
 
 
-//Installing Pipelines Operator using web console
+//Installing pipelines Operator using web console
 
 include::modules/op-installing-pipelines-operator-in-web-console.adoc[leveloffset=+1]
 
-// Installing Pipelines Operator using CLI
+// Installing pipelines Operator using CLI
 
 include::modules/op-installing-pipelines-operator-using-the-cli.adoc[leveloffset=+1]
 

cicd/pipelines/op-release-notes.adoc

@@ -14,7 +14,7 @@ toc::[]
 * Extensibility to build images using any Kubernetes tool, such as S2I, Buildah, JIB, and Kaniko.
 * Portability across any Kubernetes distribution.
 * Powerful CLI for interacting with pipelines.
-* Integrated user experience with the Developer perspective of the {product-title} web console.
+* Integrated user experience with the *Developer* perspective of the {product-title} web console.
 
 For an overview of {pipelines-title}, see xref:../../cicd/pipelines/understanding-openshift-pipelines.adoc#understanding-openshift-pipelines[Understanding OpenShift Pipelines].
 

cicd/pipelines/understanding-openshift-pipelines.adoc

@@ -8,41 +8,38 @@ toc::[]
 
 :FeatureName: OpenShift Pipelines
 
-{pipelines-title} is a cloud-native, continuous integration and continuous delivery (CI/CD) solution based on Kubernetes resources. It uses Tekton building blocks to automate deployments across multiple platforms by abstracting away the underlying implementation details. Tekton introduces a number of standard Custom Resource Definitions (CRDs) for defining CI/CD pipelines that are portable across Kubernetes distributions.
+{pipelines-title} is a cloud-native, continuous integration and continuous delivery (CI/CD) solution based on Kubernetes resources. It uses Tekton building blocks to automate deployments across multiple platforms by abstracting away the underlying implementation details. Tekton introduces a number of standard custom resource definitions (CRDs) for defining CI/CD pipelines that are portable across Kubernetes distributions.
 
-////
-{pipelines-title} is a cloud-native, continuous integration and continuous delivery (CI/CD) solution based on Kubernetes resources. It uses link:https://tekton.dev[Tekton] building blocks to automate deployments across multiple platforms by abstracting away the underlying implementation details. Tekton introduces a number of standard Custom Resource Definitions (CRDs) for defining CI/CD pipelines that are portable across Kubernetes distributions.
-////
 [id="op-key-features"]
 == Key features
 
-* {pipelines-title} is a serverless CI/CD system that runs Pipelines with all the required dependencies in isolated containers.
+* {pipelines-title} is a serverless CI/CD system that runs pipelines with all the required dependencies in isolated containers.
 * {pipelines-title} are designed for decentralized teams that work on microservice-based architecture.
 * {pipelines-title} use standard CI/CD pipeline definitions that are easy to extend and integrate with the existing Kubernetes tools, enabling you to scale on-demand.
 * You can use {pipelines-title} to build images with Kubernetes tools such as Source-to-Image (S2I), Buildah, Buildpacks, and Kaniko that are portable across any Kubernetes platform.
-* You can use the {product-title} Developer Console to create Tekton resources, view logs of Pipeline runs, and manage pipelines in your {product-title} namespaces.
+* You can use the {product-title} Developer console to create Tekton resources, view logs of pipeline runs, and manage pipelines in your {product-title} namespaces.
 
 [id="op-detailed-concepts"]
 == OpenShift Pipeline Concepts
-This guide provides a detailed view of the various Pipeline concepts.
+This guide provides a detailed view of the various pipeline concepts.
 
-//About Tasks
+//About tasks
 include::modules/op-about-tasks.adoc[leveloffset=+2]
-//About TaskRun
+//About task run
 include::modules/op-about-taskrun.adoc[leveloffset=+2]
-//About Pipelines
+//About pipelines
 include::modules/op-about-pipelines.adoc[leveloffset=+2]
-//About PipelineRun
+//About pipeline run
 include::modules/op-about-pipelinerun.adoc[leveloffset=+2]
-//About Workspace
+//About workspace
 include::modules/op-about-workspace.adoc[leveloffset=+2]
-//About Triggers
+//About triggers
 include::modules/op-about-triggers.adoc[leveloffset=+2]
 
 
 == Additional resources
 
-* For information on installing Pipelines, see xref:../../cicd/pipelines/installing-pipelines.adoc#installing-pipelines[Installing OpenShift Pipelines].
+* For information on installing pipelines, see xref:../../cicd/pipelines/installing-pipelines.adoc#installing-pipelines[Installing OpenShift Pipelines].
 * For more details on creating custom CI/CD solutions, see xref:../../cicd/pipelines/creating-applications-with-cicd-pipelines.adoc#creating-applications-with-cicd-pipelines[Creating applications with CI/CD Pipelines].
 * For more details on re-encrypt TLS termination, see link:https://docs.openshift.com/container-platform/3.11/architecture/networking/routes.html#re-encryption-termination[Re-encryption Termination].
 * For more details on secured routes, see the xref:../../networking/routes/secured-routes.adoc#secured-routes[Secured routes] section.

cicd/pipelines/working-with-pipelines-using-the-developer-perspective.adoc

@@ -8,20 +8,20 @@ include::modules/pipelines-document-attributes.adoc[]
 
 toc::[]
 
-You can use the *Developer* perspective of the {product-title} web console to create CI/CD Pipelines for your software delivery process.
+You can use the *Developer* perspective of the {product-title} web console to create CI/CD pipelines for your software delivery process.
 
 
 In the *Developer* perspective:
 
-* Use the *Add* -> *Pipeline* -> *Pipeline Builder* option to create customized Pipelines for your application.
-* Use the *Add* -> *From Git* option to create Pipelines using operator-installed Pipeline templates and resources while creating an application on {product-title}.
+* Use the *Add* -> *Pipeline* -> *Pipeline Builder* option to create customized pipelines for your application.
+* Use the *Add* -> *From Git* option to create pipelines using operator-installed pipeline templates and resources while creating an application on {product-title}.
 
-After you create the Pipelines for your application, you can view and visually interact with the deployed Pipelines in the *Pipelines* view. You can also use the *Topology* view to interact with the Pipelines created using the *From Git* option. You need to apply custom labels to a Pipeline created using the *Pipeline Builder* to see it in the *Topology* view.
+After you create the pipelines for your application, you can view and visually interact with the deployed pipelines in the *Pipelines* view. You can also use the *Topology* view to interact with the pipelines created using the *From Git* option. You need to apply custom labels to a pipeline created using the *Pipeline Builder* to see it in the *Topology* view.
 
 [discrete]
 == Prerequisites
 
-* You have access to an {product-title} cluster and have switched to the xref:../../web_console/odc-about-developer-perspective.adoc[Developer perspective] in the web console.
+* You have access to an {product-title} cluster and have switched to the xref:../../web_console/odc-about-developer-perspective.adoc[*Developer* perspective] in the web console.
 * You have the xref:../../cicd/pipelines/installing-pipelines.adoc#installing-pipelines[OpenShift Pipelines Operator installed] in your cluster.
 * You are a cluster administrator or a user with create and edit permissions.
 * You have created a project.
@@ -31,7 +31,7 @@ include::modules/op-constructing-pipelines-using-pipeline-builder.adoc[leveloffs
 
 == Creating applications with OpenShift Pipelines
 
-To create Pipelines along with applications, use the *From Git* option in the *Add* view of the *Developer* perspective. For more information, see xref:../../applications/application_life_cycle_management/odc-creating-applications-using-developer-perspective.adoc#odc-importing-codebase-from-git-to-create-application_odc-creating-applications-using-developer-perspective[Creating applications using the Developer perspective].
+To create pipelines along with applications, use the *From Git* option in the *Add* view of the *Developer* perspective. For more information, see xref:../../applications/application_life_cycle_management/odc-creating-applications-using-developer-perspective.adoc#odc-importing-codebase-from-git-to-create-application_odc-creating-applications-using-developer-perspective[Creating applications using the Developer perspective].
 
 include::modules/op-interacting-with-pipelines-using-the-developer-perspective.adoc[leveloffset=+1]