Edits to architecture/core_objects/builds file

[bfallonf]

PR in response to: #398

@mfojtik I know you only worked on part of this file, but could I ask for a tech review, please? I rewrote some sentences, arranged some info, and took out some info (commented out) as it was in the dev_guide/builds file: http://docs.openshift.com/enterprise/latest/dev_guide/builds.html#build-triggers

I also have a couple of questions:

1. Would it be possible to get an example of the buildconfig? I feel like there's a JSON example that's missing.
2. There are two procedures under "Using Private Repositories for Builds" and "Using Docker Credentials for Pushing and Pulling Images". Would you be against me moving them to the dev_guide/builds file? I feel their current location is more for context, and this is more about configuring builds.

I think that's all. Thanks in advance!

[adellape]

@bfallonf For 1) in case it helps, if you're just looking for a full buildConfig example, you can use the CLI to take a look at an existing one, for example if you created the sample-app:

$ osc edit bc ruby-sample-build

Add -o json if you want JSON specifically instead of YAML.

You could take something like that and add it into the "BuildConfig" section of this topic, and re-purpose the [horizontal] labeled list you commented out as callout fodder for the various parts around the bc example.

[bfallonf]

@adellape Oh, of course. Thanks for that. I've added a buildconfig example and put in the list into footnotes things for the file.

@mfojtik Wold still like to request a tech review.

Thanks, guys.

[mfojtik]

just a note, there will be v1 soon, but I think this applies to many other examples we have in docs... don't change it now, just a reminder

[bfallonf]

@mfojtik Good point. I've created an issue so that this can be remembered when the time comes: #428

[mfojtik]

@adellape @bfallonf comments added, otherwise LGTM

[bfallonf]

@mfojtik Cool. I have fixed up your suggested parts. If there's nothing else, I can put this onto peer review.

Thanks!

[adellape]

LGTM, merging.