diff --git a/README.md b/README.md
index 2bce02f6..e07738f0 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,7 @@
# STEM+C
+> Cloud-based programming interface
+
## Scaffolds
@@ -21,7 +23,8 @@
## Environments
-The project is divided into three conceptual environments.
+> The project is divided into three conceptual environments.
+
### Development
#### Structure
@@ -62,7 +65,7 @@ The staging environment is deployed on Heroku. It is composed of one app running
#### Running
-`stem-c-staging` is automatically built from the latest commits to `develop`. Heroku runs the container orchestration from there.
+`stem-c-staging` is automatically built from the latest commits to `release`. Heroku runs the container orchestration from there.
### Production
@@ -99,20 +102,33 @@ heroku container:release web
### Git Flow
-![Git Flow](https://nvie.com/img/git-model@2x.png)
+> We will follow this git flow for the most part — instead of individual release branches, we will have one to streamline staging deployment
-Ideally, we want our flow to resemble this. Master and develop are locked for direct commits. All commits must be made to a non-protected branch and submitted via a pull request with one approving review.
+![Git Flow](https://nvie.com/img/git-model@2x.png)
### Branches
-- `master` - Production application
-- `release/` - Staged version
-- `develop` - Working version of the application
-- `feature/-` - Based off of develop
- - ex. `feature/cms-strapi`
-- `hotfix/-` - Based off of master
- - ex. hotfix/client-cors
+#### Protected
+
+> Locked for direct commits — all commits must be made from a non-protected branch and submitted via a pull request with one approving review
+
+- **master** - Production application
+- **develop** - Working version of the application
+
+#### Non-protected
+
+> Commits can be made directly to the branch
+
+- **release** - Staging application
+- **feature/<`scaffold`>-<`feature-name`>** - Based off of develop
+ - ex. **feature/cms-strapi**
+- **hotfix/<`scaffold`>-<`fix-name`>** - Based off of master
+ - ex. **hotfix/client-cors**
### Pull Requests
-Before submitting a pull request, merge the target branch into the working branch to resolve any merge conflicts. Include a description of the changes made.
+> PRs to **master** should squash and merge
+>
+> PRs to all other branches should create a merge commit
+
+Before submitting a pull request, merge the target branch into the working branch to resolve any merge conflicts. Include a description of the changes made.
\ No newline at end of file
diff --git a/cms/README.md b/cms/README.md
index 986a1a34..b49a336e 100644
--- a/cms/README.md
+++ b/cms/README.md
@@ -1,6 +1,6 @@
# Cms
-REST API and admin portal that comprise the backend. It is powered by [Node](https://nodejs.org/en/), [Strapi](https://strapi.io/documentation/3.0.0-beta.x/getting-started/introduction.html), and [PostgreSQL](https://www.postgresql.org/). The file structure is defined by Strapi and is documented [here](https://strapi.io/documentation/3.0.0-beta.x/concepts/file-structure.html#files-structure).
+> REST API and admin portal that comprise the backend. It is powered by [Node](https://nodejs.org/en/), [Strapi](https://strapi.io/documentation/3.0.0-beta.x/getting-started/introduction.html), and [PostgreSQL](https://www.postgresql.org/). The file structure is defined by Strapi and is documented [here](https://strapi.io/documentation/3.0.0-beta.x/concepts/file-structure.html#files-structure).
@@ -24,7 +24,7 @@ Additional scripts:
## API `/`
-Built with [Node](https://nodejs.org/en/), [Koa](https://github.com/koajs/koa#readme), and [Bookshelf](https://bookshelfjs.org/), the REST API enables CRUD functionality with the application's content. Authentication is enabled via JWTs. The dbms is [PostgreSQL](https://www.postgresql.org/).
+> Built with [Node](https://nodejs.org/en/), [Koa](https://github.com/koajs/koa#readme), and [Bookshelf](https://bookshelfjs.org/), the REST API enables CRUD functionality with the application's content. Authentication is enabled via JWTs. The dbms is [PostgreSQL](https://www.postgresql.org/).
### Entity Relationships
diff --git a/compile/README.md b/compile/README.md
index 917e4357..cc4b1f10 100644
--- a/compile/README.md
+++ b/compile/README.md
@@ -1,6 +1,6 @@
# Compile
-Arduino compilier server.
+> Arduino compilier server.
@@ -23,7 +23,7 @@ Additional scripts:
## API
-The interface for this service is simple. There are three informational endpoints and one endpoint for compiling arduino code.
+> The interface for this service is simple. There are three informational endpoints and one endpoint for compiling arduino code.
| Method | Path | Description |
| ------ | ---------- | --------------------------------------------- |