Merge pull request #13544 from bmcelvee/build-overview-followup

Edits to understanding builds

Author: bmcelvee

_topic_map.yml

@@ -33,7 +33,7 @@ Name: Builds
 Dir: builds
 Distros: openshift-*
 Topics:
-- Name: How builds work
+- Name: Understanding builds
   File: understanding-builds
 - Name: Creating build inputs
   File: creating-build-inputs

builds/understanding-builds.adoc

@@ -1,5 +1,5 @@
 [id='understanding-build']
-= How builds work
+= Understanding builds
 include::modules/common-attributes.adoc[]
 :context: understanding-builds
 toc::[]

modules/builds-about.adoc

@@ -2,16 +2,12 @@
 // * assembly/builds
 
 [id='builds-about-{context}']
-= What is a build?
+= Builds
 
 A _build_ is the process of transforming input parameters into a resulting
 object (build object). Most often, the process is used to transform input
 parameters or source code into a runnable container image.
 
-A _build configuration_, or `BuildConfig`, is characterized by a _build strategy_
-and one or more sources. The strategy determines the process, while
-the sources provide its input.
-
 {product-title} uses Kubernetes by creating containers
 from build images and pushing them to a container image registry.
 
@@ -50,10 +46,10 @@ specified.
 Additionally, the Pipeline build strategy can be used to implement sophisticated
 workflows including continuous integration and continuous deployment.
 
-.Additional resources
+//.Additional resources
 
-* Container image registry.
-* List of build commands.
-* For more information on how {product-title} uses Docker for builds, see the
-link:https://github.com/openshift/origin/blob/master/docs/builds.md#how-it-works[upstream
-documentation].
+//* Container image registry.
+//* List of build commands.
+//* For more information on how {product-title} uses Docker for builds, see the
+//link:https://github.com/openshift/origin/blob/master/docs/builds.md#how-it-works[upstream
+//documentation].

modules/builds-buildconfig.adoc

@@ -2,13 +2,17 @@
 // * assembly/builds
 
 [id='builds-buildconfig-{context}']
-= What is a BuildConfig?
+= BuildConfigs
 
 A build configuration describes a single build definition and a set of
 triggers for when a new build is created. Build configurations are defined
 by a `BuildConfig`, which is a REST object that can be used in a POST to the API
 server to create a new instance.
 
+A _build configuration_, or `BuildConfig`, is characterized by a _build strategy_
+and one or more sources. The strategy determines the process, while
+the sources provide its input.
+
 Depending on how you choose to create your application using {product-title}, a
 `BuildConfig` is typically generated automatically for you if you use the web
 console or CLI, and it can be edited at any time. Understanding the parts that