diff --git a/README.md b/README.md
index 9e041db..b0e39cf 100644
--- a/README.md
+++ b/README.md
@@ -5,7 +5,7 @@
 [![Average time to resolve an issue](http://isitmaintained.com/badge/resolution/mblaschke/php-docker-boilerplate.svg)](http://isitmaintained.com/project/mblaschke/php-docker-boilerplate "Average time to resolve an issue")
 [![Percentage of issues still open](http://isitmaintained.com/badge/open/mblaschke/php-docker-boilerplate.svg)](http://isitmaintained.com/project/mblaschke/php-docker-boilerplate "Percentage of issues still open")
 
-This is an easy customizable docker boilerplate for any PHP based projects like _Symfony Framework_, _CakePHP_, _Yii_ and many other frameworks or applications.
+This is an easy customizable docker boilerplate for any PHP-based projects like _Symfony Framework_, _CakePHP_, _Yii_ and many other frameworks or applications.
 
 Supports:
 
@@ -21,15 +21,15 @@ Supports:
 - FTP server (vsftpd)
 - maybe more later...
 
-This Docker boilerplate based on the best practises and don't use too much magic.
-Configuration of each docker container is available in the `docker/` directory - feel free to customize.
+This Docker boilerplate is based on the [Docker best practices](https://docs.docker.com/articles/dockerfile_best-practices/) and doesn't use too much magic. Configuration of each docker container is available in the `docker/` directory - feel free to customize.
 
-This boilerplate can also be used for any other web project eg. Symfony, CakePHP, Magento and more.
-Just customize the makefile for your needs
+This boilerplate can also be used for any other web project. Just customize the makefile for your needs.
 
-Warning: There may be issues when using it in production - if you have any success stories please contact me.
+*Warning: There may be issues when using it in production.*
 
-You can use my [Vagrant Development VM](https://github.com/mblaschke/vagrant-development) for this Docker boilerplate, eg. for easy creating new boilerplate installations with an easy shell command: `ct docker:create directory`
+If you have any success stories please contact me.
+
+You can use my [Vagrant Development VM](https://github.com/mblaschke/vagrant-development) for this Docker boilerplate, e.g. for easily creating new boilerplate installations with short shell command: `ct docker:create directory`.
 
 ## Table of contents
 
@@ -47,7 +47,7 @@ You can use my [Vagrant Development VM](https://github.com/mblaschke/vagrant-dev
 
 This Docker layout is based on https://github.com/denderello/symfony-docker-example/
 
-Thanks for support, ideas and issues ...
+Thanks for your support, ideas and issues.
 - [Ingo Pfennigstorf](https://github.com/ipf)
 - [Florian Tatzel](https://github.com/PanadeEdu)
 - [Josef Florian Glatz](https://github.com/jousch)