iRoachie · February 7, 2016 05:27 · Aug 9, 2014 · Aug 9, 2014 · Aug 9, 2014 · Aug 9, 2014
diff --git a/deploy-single-page-site.md → deploy-static-site-heroku.md b/deploy-single-page-site.md → deploy-static-site-heroku.md
diff --git a/deploy-single-page-site.md b/deploy-single-page-site.md
@@ -1,6 +1,6 @@
 ## Gist
 
-This is a quick tutorial explaining how to deploy a single-page website to Heroku.
+This is a quick tutorial explaining how to get a static website hosted on Heroku.
 
 **Why do this?**
 

diff --git a/deploy-single-page-site.md b/deploy-single-page-site.md
@@ -19,14 +19,8 @@ Heroku hosts *apps* on the internet, not static websites. To get it to run your
 1. Add a file called *composer.json* to the root directory by running `touch composer.json`
 2. Add a file called *index.php* to the root directory by running `touch index.php`
 3. Rename the homepage (e.g. index.html) to *home.html*
-4. In *index.php*, add the following line
-```php
-<?php include_once("home.html"); ?>
-```
-5. In *composer.json*, add the following line
-```
-{}
-```
+4. In *index.php*, add the following line: `<?php include_once("home.html"); ?>`
+5. In *composer.json*, add the following line: `{}`
 6. Run `git push heroku master`
 
 Done! Visit your deployed single-page website, hosted by Heroku (as a fake PHP app ☺).
diff --git a/deploy-single-page-site.md b/deploy-single-page-site.md
@@ -14,7 +14,7 @@ Heroku hosts *apps* on the internet, not static websites. To get it to run your
 - A [Heroku app](https://devcenter.heroku.com/articles/quickstart) and remote are set up and ready to go
 
 
-Steps:
+## Steps
 
 1. Add a file called *composer.json* to the root directory by running `touch composer.json`
 2. Add a file called *index.php* to the root directory by running `touch index.php`

diff --git a/deploy-single-page-site.md b/deploy-single-page-site.md
@@ -1,3 +1,11 @@
+## Gist
+
+This is a quick tutorial explaining how to deploy a single-page website to Heroku.
+
+**Why do this?**
+
+Heroku hosts *apps* on the internet, not static websites. To get it to run your static portfolio, personal blog, etc., you need to trick Heroku into thinking your website is a PHP app. This 6-step tutorial will teach you how.
+
 ## Basic Assumptions
 
 - You want to deploy some straight-up HTML, CSS, JS, maybe a few images. Nothing fancy here.

diff --git a/deploy-single-page-site.md b/deploy-single-page-site.md
@@ -21,4 +21,4 @@ Steps:
 ```
 6. Run `git push heroku master`
 
-Done! Visit your deployed single-page website, hosted by Heroku.
+Done! Visit your deployed single-page website, hosted by Heroku (as a fake PHP app ☺).
diff --git a/deploy-single-page-site.md b/deploy-single-page-site.md
@@ -8,17 +8,17 @@
 
 Steps:
 
-1 - Add a file called *composer.json* to the root directory by running `touch composer.json`
-2 - Add a file called *index.php* to the root directory by running `touch index.php`
-3 - Rename the homepage (e.g. index.html) to *home.html*
-4 - In *index.php*, add the following line
+1. Add a file called *composer.json* to the root directory by running `touch composer.json`
+2. Add a file called *index.php* to the root directory by running `touch index.php`
+3. Rename the homepage (e.g. index.html) to *home.html*
+4. In *index.php*, add the following line
 ```php
 <?php include_once("home.html"); ?>
 ```
-5 - In *composer.json*, add the following line
+5. In *composer.json*, add the following line
 ```
 {}
 ```
-6 - Run `git push heroku master`
+6. Run `git push heroku master`
 
 Done! Visit your deployed single-page website, hosted by Heroku.
diff --git a/deploy-single-page-site.md b/deploy-single-page-site.md
@@ -0,0 +1,24 @@
+## Basic Assumptions
+
+- You want to deploy some straight-up HTML, CSS, JS, maybe a few images. Nothing fancy here.
+- You are in the root directory of your site (i.e. the directory that contains all subdirectories and files for the site)
+- The root directory contains a main HTML page, e.g. index.html
+- A [Heroku app](https://devcenter.heroku.com/articles/quickstart) and remote are set up and ready to go
+
+
+Steps:
+
+1 - Add a file called *composer.json* to the root directory by running `touch composer.json`
+2 - Add a file called *index.php* to the root directory by running `touch index.php`
+3 - Rename the homepage (e.g. index.html) to *home.html*
+4 - In *index.php*, add the following line
+```php
+<?php include_once("home.html"); ?>
+```
+5 - In *composer.json*, add the following line
+```
+{}
+```
+6 - Run `git push heroku master`
+
+Done! Visit your deployed single-page website, hosted by Heroku.