Merge pull request #287 from secrethub/update-readme

Update readme

Author: mackenbach

README.md

@@ -13,43 +13,65 @@
 
 The SecretHub CLI provides the command-line interface to interact with the SecretHub API.
 
-> [SecretHub][secrethub] is an end-to-end encrypted secret management service that helps developers keep database passwords, API keys, and other secrets out of source code.
+> [SecretHub][secrethub] is a secret management platform that every engineer can use. Securely provision passwords and keys throughout your entire stack with just a few lines of code.
+
+## Get started
+
+Follow the [Getting Started Guide][getting-started] to quickly get up and running with SecretHub :rocket:
 
 ## Usage
 
+Below you can find a selection of some of the most-used SecretHub commands. Run `secrethub --help` or the [CLI reference docs][cli-reference-docs] for a complete list of all commands.
+
+### Reading and writing secrets
 ```sh
-$ secrethub write path/to/secret
-Type in your secret: ************************  
+$ secrethub read <path/to/secret>
+Print a secret to stdout.
 
-$ cat config.yml.tpl
-db_user: myapp
-db_password: {{ path/to/secret:latest }}
+$ secrethub generate <path/to/secret>
+Generate a random value and store it as a new version of a secret
 
-$ cat config.yml.tpl | secrethub inject
-db_user: myapp
-db_password: LEYkTdMCksCVMc4X3gpYN0fk
+$ secrethub write <path/to/secret>
+Ask for a value to store as a secret.
+
+$ echo "mysecret" | secrethub write <path/to/secret>
+Store a piped value as a secret.
+
+$ secrethub write -i <filename> <path/to/secret>
+Store the contents of a file as a secret.
 ```
 
-See the [reference docs][reference-docs] for a detailed overview of all commands.
+### Provisioning your applications with secrets
+```sh
+$ export MYSECRET=secrethub://path/to/secret
+$ secrethub run -- <executable/script>
+Automatically load secrets into environment variables and provide them to the wrapped executable or script.
 
-## Get started
+$ echo "mysecret: {{path/to/secret}}" | secrethub inject
+Read a configuration template from stdin and automatically inject secrets into it.
+```
 
-### 1. [Download][installation-guide] the CLI.  
+### Access control
+```sh
+$ secrethub service init <namespace>/<repo> --permission <dir>:<read/write/admin>
+Create a service account for the given repository and automatically grant read, write or admin permission on the given directory.
 
-Official distributions are available for Linux, macOS, and Windows for both `386` (32-bit) and `amd64` (64-bit) architectures.
+$ secrethub acl set <path/to/directory> <account-name> <read/write/admin>
+Grant an account read, write or admin permission on a directory.
 
-Check out the [installation guide][installation-guide] for detailed instructions on how to install the SecretHub CLI on your platform of choice.
+$ secrethub repo revoke <namespace>/<repo> <account-name>
+Revoke an account's access to a repository.
+```
 
-### 2. Run `signup`
+## Integrations
 
-Run `signup` to claim your free developer account:
+SecretHub integrates with all the tools you already know and love.
 
-```
-secrethub signup
-```
+<p align="left">
+  <img src="https://secrethub.io/img/features/integrations.png" width="450px" />
+</p>
 
-And you're done. 
-Follow the [getting started guide][getting-started] for a brief introduction into the basics of SecretHub.
+Check out the [Integrations](integrations) page to find out how SecretHub works with your tools.
 
 ## Getting help
 
@@ -93,10 +115,10 @@ Run a single test:
 
 
 
-[secrethub]: https://secrethub.io
+[secrethub]: https://secrethub.io/
 [getting-started]: https://secrethub.io/docs/getting-started/
-[installation-guide]: https://secrethub.io/docs/getting-started/install
-[reference-docs]: https://secrethub.io/docs/reference/
+[cli-reference-docs]: https://secrethub.io/docs/reference/cli/
+[integrations]: https://secrethub.io/integrations/
 [releases]: https://github.com/secrethub/secrethub-cli/releases
 [latest-version]: https://github.com/secrethub/secrethub-cli/releases/latest
 [godoc]: http://godoc.org/github.com/secrethub/secrethub-cli