diff --git a/README.md b/README.md
index 9c8439c..c222cb9 100644
--- a/README.md
+++ b/README.md
@@ -74,7 +74,7 @@ Put your CI (travis, circle, drone) configurations and scripts in the `/build/ci
 
 * `/deployments`
 
-IaaS, PaaS, system and container orchestration deployment configurations and templates (docker-compose, kubernetes/helm, mesos, terraform).
+IaaS, PaaS, system and container orchestration deployment configurations and templates (docker-compose, kubernetes/helm, mesos, terraform, bosh).
 
 * `/test`
 
@@ -84,7 +84,7 @@ Additional external test apps and test data.
 
 * `/docs`
 
-Design and user documents.
+Design and user documents (in addition to your godoc generated documentation).
 
 * `/tools`
 
@@ -106,7 +106,11 @@ Git hooks.
 
 Other assets to go along with your repository.
 
+## Badges
 
+[![Go Report Card](https://goreportcard.com/badge/github.com/golang-standards/project-layout?style=flat-square)](https://goreportcard.com/report/github.com/golang-standards/project-layout)
+[![Go Doc](https://img.shields.io/badge/godoc-reference-blue.svg?style=flat-square)](http://godoc.org/github.com/golang-standards/project-layout)
+[![Release](https://img.shields.io/github/release/golang-standards/project-layout.svg?style=flat-square)](https://github.com/golang-standards/project-layout/releases/latest)