Merge pull request #36660 from HarshCasper/RHDEVDOCS-3104

RHDEVDOCS-3104: Add docs for editing BuildConfig using Developer perspective

Author: Preeticp

_topic_map.yml

@@ -1447,7 +1447,7 @@ Topics:
   - Name: Custom image builds with Buildah
     File: custom-builds-buildah
     Distros: openshift-enterprise,openshift-origin
-  - Name: Performing basic builds
+  - Name: Performing and configuring basic builds
     File: basic-build-operations
     Distros: openshift-enterprise,openshift-origin,openshift-dedicated,openshift-online
   - Name: Triggering and modifying builds

cicd/builds/basic-build-operations.adoc

@@ -1,11 +1,11 @@
 [id="basic-build-operations"]
-= Performing basic builds
+= Performing and configuring basic builds
 include::modules/common-attributes.adoc[]
 :context: basic-build-operations
 
 toc::[]
 
-The following sections provide instructions for basic build operations including starting and canceling builds, deleting BuildConfigs, viewing build details, and accessing build logs.
+The following sections provide instructions for basic build operations, including starting and canceling builds, editing `BuildConfigs`, deleting `BuildConfigs`, viewing build details, and accessing build logs.
 
 include::modules/builds-basic-start-build.adoc[leveloffset=+1]
 include::modules/builds-basic-start-re-run.adoc[leveloffset=+2]
@@ -16,6 +16,7 @@ include::modules/builds-basic-cancel-build.adoc[leveloffset=+1]
 include::modules/builds-basic-cancel-multiple.adoc[leveloffset=+2]
 include::modules/builds-basic-cancel-all.adoc[leveloffset=+2]
 include::modules/builds-basic-cancel-all-state.adoc[leveloffset=+2]
+include::modules/builds-basic-edit-buildconfig.adoc[leveloffset=+1]
 include::modules/builds-basic-delete-buildconfig.adoc[leveloffset=+1]
 include::modules/builds-basic-view-build-details.adoc[leveloffset=+1]
 include::modules/builds-basic-access-build-logs.adoc[leveloffset=+1]

modules/builds-basic-edit-buildconfig.adoc

@@ -0,0 +1,43 @@
+// Module included in the following assemblies:
+// * builds/basic-build-operations.adoc
+
+[id="builds-basic-edit-buildconfig_{context}"]
+= Editing a BuildConfig
+
+To edit your build configurations, you use the *Edit BuildConfig* option in the *Builds* view of the *Developer* perspective.
+
+You can use either of the following views to edit a `BuildConfig`:
+
+* The *Form view* enables you to edit your `BuildConfig` using the standard form fields and checkboxes.
+* The *YAML view* enables you to edit your `BuildConfig` with full control over the operations.
+
+You can switch between the *Form view* and *YAML view* without losing any data. The data in the *Form view* is transferred to the *YAML view* and vice versa.
+
+.Procedure
+
+. In the *Builds* view of the *Developer* perspective, click the menu {kebab} to see the *Edit BuildConfig* option.
+. Click *Edit BuildConfig* to see the *Form view* option.
+. In the *Git* section, enter the Git repository URL for the codebase you want to use to create an application. The URL is then validated.
+* Optional: Click *Show Advanced Git Options* to add details such as:
+** *Git Reference* to specify a branch, tag, or commit that contains code you want to use to build the application.
+** *Context Dir* to specify the subdirectory that contains code you want to use to build the application.
+** *Source Secret* to create a *Secret Name* with credentials for pulling your source code from a private repository.
+. In the *Build from* section, select the option that you would like to build from. You can use the following options:
+** *Image Stream tag* references an image for a given image stream and tag. Enter the project, image stream, and tag of the location you would like to build from and push to.
+** *Image Stream image* references an image for a given image stream and image name. Enter the image stream image you would like to build from. Also enter the project, image stream, and tag to push to.
+** *Docker image*: The Docker image is referenced through a Docker image repository. You will also need to enter the project, image stream, and tag to refer to where you would like to push to.
+. Optional: In the *Environment Variables* section, add the environment variables associated with the project by using the *Name* and *Value* fields. To add more environment variables, use *Add Value*, or *Add from ConfigMap* and *Secret* .
+. Optional: To further customize your application, use the following advanced options:
+Trigger::
+Triggers a new image build when the builder image changes. Add more triggers by clicking *Add Trigger* and selecting the *Type* and *Secret*.
+
+Secrets::
+Adds secrets for your application. Add more secrets by clicking *Add secret* and selecting the *Secret* and *Mount point*.
+
+Policy::
+Click *Run policy* to select the build run policy. The selected policy determines the order in which builds created from the build configuration must run.
+
+Hooks::
+Select *Run build hooks after image is built* to run commands at the end of the build and verify the image. Add *Hook type*, *Command*, and *Arguments* to append to the command.
+
+. Click *Save* to save the `BuildConfig`.