diff --git a/README-upgrade.md b/README-upgrade.md
index 6cc215c..e14dfe2 100644
--- a/README-upgrade.md
+++ b/README-upgrade.md
@@ -16,4 +16,8 @@
 | opdk_version | 4.18.01 | This indicates the target opdk version to be installed. This is also set during a clean installation of OPDK. | 
 | upgrade_from_opdk_version | 4.16.01, 4.16.05, 4.16.09, 4.17.01, 4.17.05, 4.17.09 | This variable should be set to one of the values listed. This indicates the version of opdk that you would be upgrading from |
 
+ ## Upgrading Using an Apigee Mirror
+ 
+ If you are using locally accessed Apigee Mirror it will be necessary to upgrade the Apigee Mirror to your target `opdk_version`. 
+ Once you have upgraded your mirror you would be able to use this script to upgrade edge.
  
\ No newline at end of file
diff --git a/README.md b/README.md
index 3557d0f..bb1c156 100644
--- a/README.md
+++ b/README.md
@@ -2,7 +2,16 @@
 
 This repository contains Ansible playbooks that use roles to install Apigee Edge, Developer Portal, Baas and the 
 Monitoring Dashboard. These playbooks orchestrate the usage of the roles to achieve the installation, upgrade and maintenance 
-of the Edge platform. Please see the links below for descriptions and usage instructions. 
+of the Edge platform. Please see the links below for descriptions and instructions specific to your activity. 
+
+## General Usage Instructions
+
+Ansible playbooks are invoked at the command line. The assumption is that you know Ansible or are capable of learning Ansible 
+quickly. 
+
+### Ansible Playbooks
+Ansible playbooks are always invoked using `ansible-playbook`. Please 
+refer to [Ansible Documentation](http://docs.ansible.com/ansible/latest) for details on installing and running Ansible.
  
 ## Installing, Updating and Maintaining Apigee Components and Support Servers 
 | Playbook Description | Playbook Name | Playbook Role Requirements |