diff --git a/README.md b/README.md
index 1a50638..0c68c7f 100644
--- a/README.md
+++ b/README.md
@@ -1,11 +1,32 @@
-# BigchainDB
+# [](https://www.bigchaindb.com)
-> Landing page for BigchainDB
+> The fabulous cat of blockchain websites.
[](https://travis-ci.com/ascribe/bigchain-website)
+
+
+
+
+---
[Live](https://www.bigchaindb.com) | [Styleguide](https://www.bigchaindb.com/styleguide/) | [Beta](http://beta.bigchaindb.com) | [Gamma](http://gamma.bigchaindb.com)
+---
+
+## Table of Contents
+
+* [Development](#development)
+ * [Install dependencies](#install-dependencies)
+ * [Development build](#development-build)
+* [Continuous deployment: always be shipping](#continuous-deployment-always-be-shipping)
+* [Manual deployment](#manual-deployment)
+ * [Prerequisite: authentication](#prerequisite-authentication)
+ * [Staging build & beta deployment](#staging-build--beta-deployment)
+ * [Production build & live deployment](#production-build--live-deployment)
+* [Coding conventions](#coding-conventions)
+ * [(S)CSS](#scss)
+* [Authors](#authors)
+
## Development
You need to have the following tools installed on your development machine before moving on:
@@ -37,19 +58,23 @@ Spin up local dev server and livereloading watch task, reachable under [https://
gulp
```
-## Continuous Delivery
+## Continuous deployment: always be shipping
-The site gets built & deployed automatically via Travis under the following conditions:
+
+
+The site gets built & deployed automatically via Travis. This is the preferred way of deployment, it makes sure the site is always deployed with fresh dependencies and only after a successful build.
+
+Build & deployment happens under the following conditions on Travis:
- every push builds the site
-- every push to the master branch initiates a live deployment
-- every pull request initiates a beta deployment
+- **live deployment**: every push to the master branch initiates a live deployment
+- **beta deployment**: every new pull request and every subsequent push to it initiates a beta deployment
-## Manual Deployment
+## Manual deployment
-The site is hosted in an S3 bucket and gets deployed via a gulp task.
+For emergency live deployments or beta & gamma deployments, the manual method can be used. The site is hosted in an S3 bucket and gets deployed via a gulp task.
-### Prerequisite: Authentication
+### Prerequisite: authentication
To deploy the site, you must authenticate yourself against the AWS API with your AWS credentials. Get your AWS access key and secret and add them to `~/.aws/credentials`:
@@ -61,17 +86,17 @@ aws_secret_access_key =
This is all that is needed to authenticate with AWS if you've setup your credentials as the default profile.
-If you've set them up as another profile, say `[bigchain]` you can grab those credentials by using the `AWS_PROFILE` variable like so:
+If you've set them up as another profile, say `[bigchaindb]` you can grab those credentials by using the `AWS_PROFILE` variable like so:
```bash
-AWS_PROFILE=bigchain gulp deploy --live
+AWS_PROFILE=bigchaindb gulp deploy --live
```
In case that you get authentication errors or need an alternative way to authenticate with AWS, check out the [AWS documentation](http://docs.aws.amazon.com/AWSJavaScriptSDK/guide/node-configuring.html).
### Staging build & beta deployment
-The staging build is essentially a full production build but it prevents search engine indexing & Google Analytics tracking.
+The staging build is a full production build but prevents search engine indexing & Google Analytics tracking.
```bash
# make sure your local npm packages & gems are up to date
@@ -119,3 +144,7 @@ Rule exceptions:
- indentation: 4 spaces
- use single quotes
- allow single line rule sets
+
+## Authors
+
+- Matthias Kretschmann ([@kremalicious](https://github.com/kremalicious)) - [BigchainDB](https://www.bigchaindb.com)
diff --git a/media/repo-banner.sketch b/media/repo-banner.sketch
new file mode 100644
index 0000000..eccf88a
Binary files /dev/null and b/media/repo-banner.sketch differ
diff --git a/media/repo-banner@2x.png b/media/repo-banner@2x.png
new file mode 100644
index 0000000..a8c2300
Binary files /dev/null and b/media/repo-banner@2x.png differ