Merge pull request #4645 from gaurav-nelson/Bug1462823Fixes

Bug#1462823 - Fixes

install_config/configuring_aws.adoc

@@ -32,7 +32,7 @@ Zone = us-east-1c <1>
 <1> This is the Availability Zone of your AWS Instance and where your EBS Volume
 resides; this information is obtained from the AWS Managment Console.
 ====
- 
+
 [[aws-configuring-masters]]
 == Configuring {product-title} Masters for AWS
 
@@ -45,12 +45,12 @@ You can set the AWS configuration on your {product-title} master hosts in two wa
 === Configuring {product-title} for AWS with Ansible
 
 During
-xref:../install_config/install/advanced_install.adoc#install-config-install-advanced-install[advanced installations], 
-AWS can be configured using 
-xref:../install_config/install/advanced_install.adoc#advanced-install-configuring-global-proxy[the `*openshift_cloudprovider_aws_access_key*`, `*openshift_cloudprovider_aws_secret_key*`, and `*openshift_cloudprovider_kind*` parameters], which are configurable in the inventory file. 
+xref:../install_config/install/advanced_install.adoc#install-config-install-advanced-install[advanced installations],
+AWS can be configured using
+xref:../install_config/install/advanced_install.adoc#advanced-install-configuring-global-proxy[the `*openshift_cloudprovider_aws_access_key*`, `*openshift_cloudprovider_aws_secret_key*`, and `*openshift_cloudprovider_kind*` parameters], which are configurable in the inventory file.
 
 .Example AWS Configuration with Ansible
-====
+
 ----
 # Cloud Provider Configuration
 #
@@ -60,13 +60,15 @@ xref:../install_config/install/advanced_install.adoc#advanced-install-configurin
 #openshift_cloudprovider_aws_access_key="{{ lookup('env','AWS_ACCESS_KEY_ID') }}"
 #openshift_cloudprovider_aws_secret_key="{{ lookup('env','AWS_SECRET_ACCESS_KEY') }}"
 #
-# AWS
+# AWS (Using API Credentials)
 #openshift_cloudprovider_kind=aws
-# Note: IAM profiles may be used instead of storing API credentials on disk.
 #openshift_cloudprovider_aws_access_key=aws_access_key_id
 #openshift_cloudprovider_aws_secret_key=aws_secret_access_key
+#
+# AWS (Using IAM Profiles)
+#openshift_cloudprovider_kind=aws
+# Note: IAM roles must exist before launching the instances.
 ----
-====
 
 [NOTE]
 ====