Modernize README with better install steps

Author: carlbennett

README.md

@@ -1,8 +1,7 @@
-# BNETDocs: Phoenix
+# BNETDocs
 
 [![Build Status](https://travis-ci.org/BNETDocs/bnetdocs-web.svg?branch=phoenix)](https://travis-ci.org/BNETDocs/bnetdocs-web)
 
-## Preface
 BNETDocs is a web content management system (CMS) and documentation software
 for the Battle.net™ online gaming service's protocol. It provides a means
 for documenting the protocol and encouraging discussion on it.
@@ -21,34 +20,70 @@ the root of this repository for more info.
 
 ## Installation
 
-1. Clone this repository to a local directory on your development environment.
- - Recommended location: `/home/nginx/bnetdocs-local/`
-2. Setup an nginx/php-fpm web server using
-   [nginx-conf](https://github.com/carlbennett/nginx-conf) as the config.
-3. Copy the `/etc/nginx-vhost-sample.conf` file to your local nginx.
- - Recommended location: `/etc/nginx/sites-available/local.bnetdocs.org.conf`
-4. Create a symbolic link from
-   `/etc/nginx/sites-available/local.bnetdocs.org.conf` to
-   `/etc/nginx/sites-enabled/local.bnetdocs.org.conf`.
-5. Reconfigure your `local.bnetdocs.org.conf` file as necessary to work with
-   your environment. You will need to modify the `server_name` directives and
-   even quite possibly remove some `server` blocks.
-6. Install additional php modules:
- - php-gmp
- - php-mbstring
- - php-mcrypt
- - php-memcache
- - php-memcached
- - php-mysqlnd
- - php-pdo
- - php-pecl-geoip
- - php-pecl-http
- - php-pecl-jsonc
-7. Start nginx and php-fpm on your server and ensure they begin running.
-8. Import and setup the sample database.
-9. Copy `/etc/config.sample.json` to `/etc/config.phoenix.json` and modify it
-   to your environment.
-10. Try accessing this endpoint:
-   [local.bnetdocs.org](https://local.bnetdocs.org)
- - You may need to modify your `/etc/hosts` file if your development
+### Clone this repository
+```sh
+cd ~
+git clone git@github.com:BNETDocs/bnetdocs-web.git
+```
+
+### Install nginx
+Follow the guide available over at
+[carlbennett/nginx-conf](https://github.com/carlbennett/nginx-conf).
+
+After successfully installing **carlbennett/nginx-conf**, run:
+
+```sh
+sudo cp ./etc/nginx-vhost-sample.conf \
+  /etc/nginx/sites-available/local.bnetdocs.org.conf
+sudo ln -s \
+  /etc/nginx/sites-available/local.bnetdocs.org.conf \
+  /etc/nginx/sites-enabled/
+```
+
+After running the above, modify the new file to your liking. It's recommended
+to update the `server_name` directives to `local.bnetdocs.org`. Please look
+over the file and perform any updates to it as you see fit.
+
+### Install php-fpm
+#### CentOS 7.x / Fedora 24
+```sh
+sudo yum install php-fpm
+```
+
+#### Debian / Ubuntu
+```sh
+sudo apt-get update && sudo apt-get install php-fpm
+```
+
+### Satisfy composer
+Run `composer install` at the root of the repository.
+
+### Run nginx and php-fpm
+#### CentOS 7.x / Fedora 24
+```sh
+sudo systemctl start nginx php-fpm
+```
+
+#### Debian / Ubuntu
+```sh
+sudo /etc/init.d/nginx start && sudo /etc/init.d/php-fpm start
+```
+
+### Import sample database
+```sh
+mysql < ./etc/database.sample.sql
+```
+
+### Configure BNETDocs
+```sh
+cp ./etc/config.sample.json ./etc/config.phoenix.json
+```
+
+\* Open `config.phoenix.json` in your favorite text editor and modify it to
+   your liking.
+
+### Test
+Try accessing this endpoint: [local.bnetdocs.org](https://local.bnetdocs.org)
+
+\* You may need to modify your `/etc/hosts` file if your development
    environment is not your localhost.