summaryrefslogtreecommitdiffstats
path: root/docs/core_concepts_guide.adoc
diff options
context:
space:
mode:
authorThomas Wiest <twiest@users.noreply.github.com>2015-05-26 16:44:57 -0400
committerThomas Wiest <twiest@redhat.com>2015-05-27 14:46:07 -0400
commit8eee869d92056064ccbcac6bee0b553f37cd1ed1 (patch)
tree60bb24581934944e572cff2d20bb63ed3c0ee586 /docs/core_concepts_guide.adoc
parent5cf4c381c48e3286b1c7417d9873e39ba93cd1a0 (diff)
parent1e1de9761184eb0732d4880bfb4188097530249f (diff)
downloadopenshift-8eee869d92056064ccbcac6bee0b553f37cd1ed1.tar.gz
openshift-8eee869d92056064ccbcac6bee0b553f37cd1ed1.tar.bz2
openshift-8eee869d92056064ccbcac6bee0b553f37cd1ed1.tar.xz
openshift-8eee869d92056064ccbcac6bee0b553f37cd1ed1.zip
Added 80 character SHOULD to style guide, added a better example for environment in core concepts, added ansible roles flat hierarchy to best practices
Diffstat (limited to 'docs/core_concepts_guide.adoc')
-rw-r--r--docs/core_concepts_guide.adoc9
1 files changed, 5 insertions, 4 deletions
diff --git a/docs/core_concepts_guide.adoc b/docs/core_concepts_guide.adoc
index 0d746bfb5..38187c55e 100644
--- a/docs/core_concepts_guide.adoc
+++ b/docs/core_concepts_guide.adoc
@@ -4,12 +4,12 @@
The purpose of this guide is to describe core concepts used in this repository.
-It is important to note that this repository may not currently implement all of the concepts, but our intention is that it will.
+It is important to note that this repository may not currently implement all of the concepts, but the intention is that it will.
== Logical Grouping Concepts
-The following are the concepts we use to logically group OpenShift cluster instances.
+The following are the concepts used to logically group OpenShift cluster instances.
-We use these groupings to perform operations specifically against instances in the specified group.
+These groupings are used to perform operations specifically against instances in the specified group.
For example, run an Ansible playbook against all instances in the `production` environment, or run an adhoc command against all instances in the `acme-corp` cluster group.
@@ -35,7 +35,8 @@ Defined Cluster Group:
=== Environment
An environment is a logical grouping of one or more cluster groups. How the environment is defined is determined by the OpenShift administrators.
-Example: Extending the two examples above, Hosting Corp could provide both production and staging environments for it's customers. In this way, Acme Corp could push their code to the staging environment and test it out before pushing it to production.
+Example: Extending the two examples above, Hosting Corp is upgrading to the latest version of OpenShift. Before deploying it to their clusters in the Production environment, they want to test it out. So, Hosting Corp runs an Ansible playbook specifically against all of the cluster groups in the Staging environment in order to do the OpenShift upgrade.
+
Defined Environments:
`production`