Merge branch 'master' of https://github.com/MasoniteFramework/masonite

Author: josephmancuso

readme.md

@@ -7,14 +7,16 @@
 
 <img src="https://travis-ci.org/MasoniteFramework/masonite.svg?branch=master">
 <img src="https://img.shields.io/badge/python-3.4+-blue.svg" alt="Python Version"> <img src="http://pepy.tech/badge/masonite?1" alt="License">  <img src="https://img.shields.io/github/license/MasoniteFramework/masonite.svg" alt="License"> 
-<img src="https://coveralls.io/repos/github/MasoniteFramework/core/badge.svg?branch=master" alt="License"> 
-
+<img src="https://coveralls.io/repos/github/MasoniteFramework/core/badge.svg?branch=master#" alt="License">
+<a href="https://gitter.im/masonite-framework/Lobby"><img src="https://img.shields.io/badge/gitter-join%20chat%20%E2%86%92-brightgreen.svg" alt="gitter"></a>
 
 </p>
 
 ## About Masonite
 
-Masonite is the rapid application Python development framework that strives for elegant, readable, and beautiful syntax. Masonite makes building web applications fun, enjoyable and scalable. Masonite takes much of the pain out of developing web applications from simple payment systems to removing mundane development tasks with a command line companion tool called craft commands. Masonite removes much of the mundane tasks of building web applications by:
+The modern and developer centric Python web framework that strives for an actual batteries included developer tool with a lot of out of the box functionality with an extremely extendable architecture. Masonite is perfect for beginner developers getting into their first web applications as well as experienced devs that need to utilize the full expotential of Masonite to get their applications done.
+
+Masonite works hard to be fast and easy from install to deployment so developers can go from concept to creation in as quick and efficiently as possible. Use it for your next SaaS! Try it once and you’ll fall in love.
 
 * Having a simple and expressive routing engine
 * Extremely powerful command line helpers called `craft` commands
@@ -28,6 +30,8 @@ Masonite is the rapid application Python development framework that strives for
 
 Masonite strives to have extremely comprehensive documentation. All documentation can be [Found Here](https://masoniteframework.gitbooks.io/docs/content/) and would be wise to go through the tutorials there. If you find any discrepencies or anything that doesn't make sense, be sure to comment directly on the documentation to start a discussion!
 
+Also be sure to join the [Slack channel](https://masoniteframework.gitbooks.io/docs/content/)!
+
 ## Linux
 
 If you are running on a Linux flavor, you’ll need a few extra packages before you start. You can download these packages by running:
@@ -45,14 +49,27 @@ $ sudo apt-get install python3.6-dev libssl-dev
 ## Installation:
 
 ```
-    $ pip install masonite-cli
+    $ pip3 install masonite-cli :: (may need sudo if using UNIX) ::
     $ craft new project
     $ cd project
     $ craft install
     $ craft serve
 ```
 
 Go to `http://localhost:8000/`
+****
+
+<p align="center">
+* * * *
+</p>
+
+Not all computers are made the same so you may have some trouble installing Masonite depending on your machine. If you have any issues be sure to read the [Known Installation Issues](https://docs.masoniteproject.com/prologue/known-installation-issues) Documentation.
+
+<p align="center">
+* * * *
+</p>
+
+****
 
 ## Contributing
 
@@ -82,7 +99,19 @@ You can easily create new applications with `craft`. To create a new application
 
     $ craft new project_name
 
-**NOTE: If you do not have the craft command, you can run `pip install masonite-cli` which will install `craft` and `craft-vendor` command line tools.**
+****
+
+<p align="center">
+* * * *
+</p>
+
+NOTE: If you do not have the craft command, you can run `pip install masonite-cli` which will install `craft` and `craft-vendor` command line tools.
+
+<p align="center">
+* * * *
+</p>
+
+****
 
 This command will create a new directory called `project_name` with our new Masonite project.
 
@@ -94,7 +123,20 @@ Now we just need to add the pip dependencies. You can run `pip3 install -r "requ
 
     $ craft install
 
-**NOTE: Python craft commands are essentially wrappers around common mundane tasks. Read the docs about the craft command tool to learn more**
+****
+
+<p align="center">
+* * * *
+</p>
+
+NOTE: Python craft commands are essentially wrappers around common mundane tasks. Read the docs about the craft command tool to learn more
+
+<p align="center">
+* * * *
+</p>
+
+****
+
 
 This will install all the required dependencies to run this framework. Now we can run the `craft` command:
 
@@ -109,6 +151,12 @@ If that port is blocked you can specify a port by running:
 Or specify a host by running:
 
     $ craft serve --host 192.168.1.283
+   
+The server can also be auto reloaded by passing in a `-r` flag (short for `--reload`)
+
+    $ craft serve -r
+   
+This will reload the server when Masonite detects file changes. This is very similiar to Django.
 
 ## Hello World
 
@@ -127,7 +175,19 @@ ROUTES = [
 ]
 ```
 
-**NOTE: Notice this new interesting string syntax in our route. This will grant our route access to a controller (which we will create below)**
+****
+
+<p align="center">
+* * * *
+</p>
+
+NOTE: Notice this new interesting string syntax in our route. This will grant our route access to a controller (which we will create below)
+
+<p align="center">
+* * * *
+</p>
+
+****
 
 Since we used a string controller we don't have to import our controller into this file. All imports are done through Masonite on the backend.