Merge pull request #27 from Azure/rrandall/readme-update

Update README.md

README.md

@@ -1,6 +1,8 @@
 # Microsoft Azure Key Vault SDK for Java
 
-This is the Microsoft Azure Key Vault client library which allows for the consumption of Key Vault services.
+This is the Microsoft Azure Key Vault client library which allows for the consumption of Key Vault services. Azure Key Vault helps safeguard cryptographic keys and secrets used by cloud applications and services. By using Key Vault, you can encrypt keys and secrets (such as authentication keys, storage account keys, data encryption keys, .PFX files, and passwords) using keys protected by hardware security modules (HSMs). For added assurance, you can import or generate keys in HSMs. If you choose to do this, Microsoft processes your keys in FIPS 140-2 Level 2 validated HSMs (hardware and firmware).
+Key Vault streamlines the key management process and enables you to maintain control of keys that access and encrypt your data. Developers can create keys for development and testing in minutes, and then seamlessly migrate them to production keys. Security administrators can grant (and revoke) permission to keys, as needed.
+For more information refer to [What is Key Vault?](https://docs.microsoft.com/en-us/azure/key-vault/key-vault-whatis) or [Getting Started](https://docs.microsoft.com/en-us/azure/key-vault/key-vault-get-started).
 
 ## Sample code
 You can find sample code that illustrates key vault usage scenarios [here](https://azure.microsoft.com/en-us/resources/samples/?sort=0&service=key-vault&platform=java).
@@ -45,7 +47,9 @@ To get the binaries of this library as distributed by Microsoft, ready for use w
 
 Clone the repo, then run `mvn compile` from the root directory.
 
-To run the recorded tests, run `mvn jetty:run` to start a jetty server, then run `mvn test`.
+To run the recorded tests:
+1. run `mvn jetty:run` to start a jetty server. This starts a service that will block the terminal so you will likely want to open a second terminal to run the actual tests.
+2. In your second terminal run `mvn test`.
 
 ## Contributing