add Keep track of your Laradock changes section to the docs

Author: Mahmoudz

README.md

@@ -59,6 +59,7 @@ Laradock is configured to run Laravel Apps by default, and it can be modified to
 		- [Change the PHP-CLI Version](#Change-the-PHP-CLI-Version)
 		- [Install xDebug](#Install-xDebug)
 		    - [Start/Stop xDebug](#Control-xDebug)
+		- [Install Deployer](#Install-Deployer)
 	- [Production](#Production)
 		- [Prepare LaraDock for Production](#LaraDock-for-Production)
 		- [Setup Laravel and Docker on Digital Ocean](#Digital-Ocean)
@@ -90,17 +91,19 @@ Laradock is configured to run Laravel Apps by default, and it can be modified to
 		- [Install Node + YARN](#Install-Yarn)
 		- [Install Linuxbrew](#Install-Linuxbrew)
 		- [Common Terminal Aliases](#Common-Aliases)
-		- [Install Deployer](#Install-Deployer)
-		- [Debugging](#debugging)
+		- [Install Aerospike extension](#Install-Aerospike-Extension)
+		- [Install Laravel Envoy](#Install-Laravel-Envoy)
+		- [PHPStorm Debugging Guide](#phpstorm-debugging)
+		- [Keep track of your Laradock changes](#keep-tracking-Laradock)
 		- [Upgrading LaraDock](#upgrading-laradock)
+	- [Common Problems](#Common-Problems)
 - [Related Projects](#related-projects)
 - [Help & Questions](#Help)
 
 
 
 
 
-
 ### Quick Overview:
 
 Let's see how easy it is to install `NGINX`, `PHP`, `Composer`, `MySQL`, `Redis` and `Beanstalkd`:
@@ -279,7 +282,6 @@ What's better than a **Demo Video**:
 
 
 
-
 <a name="Installation"></a>
 ## Installation
 
@@ -294,11 +296,14 @@ Choose the setup the best suits your needs.
 1 - Clone this repository on your project root directory:
 
 ```bash
-git submodule add https://github.com/LaraDock/laradock.git
+git submodule add https://github.com/Laradock/laradock.git
 ```
->If you are not already using Git for your PHP project, you can use `git clone` instead of `git submodule`.
 
-Note: In this case the folder structure will be like this:
+*Note 1: If you are not yet using Git for your PHP project, you can use `git clone https://github.com/Laradock/laradock.git` instead.*
+
+*Note 2: To keep track of your Laradock changes, between your projects and also keep Laradock updated. [Check this](#keep-tracking-Laradock)*
+
+*Note 3: In this case the folder structure will be like this:*
 
 ```
 - project1
@@ -794,6 +799,36 @@ To control the behavior of xDebug (in the `php-fpm` Container), you can run the
 
 
 
+<br>
+<a name="Install-Deployer"></a>
+### Install Deployer (Deployment tool for PHP)
+
+1 - Open the `docker-compose.yml` file
+<br>
+2 - Search for the `INSTALL_DEPLOYER` argument under the Workspace Container
+<br>
+3 - Set it to `true`
+<br>
+
+It should be like this:
+
+```yml
+    workspace:
+        build:
+            context: ./workspace
+            args:
+                - INSTALL_DEPLOYER=true
+    ...
+```
+
+4 - Re-build the containers `docker-compose build workspace`
+
+######[Deployer Documentation Here](https://deployer.org/docs)
+
+
+
+
+
 <br>
 <a name="Production"></a>
 
@@ -1299,6 +1334,7 @@ To install CodeIgniter 3 on Laradock all you have to do is the following simple
 
 <br>
 <a name="Misc"></a>
+## Miscellaneous
 
 
 
@@ -1660,61 +1696,65 @@ It should be like this:
 
 4 - Re-build the containers `docker-compose build workspace`
 
-####[Laravel Envoy Documentation Here](https://laravel.com/docs/5.3/envoy)
+######[Laravel Envoy Documentation Here](https://laravel.com/docs/5.3/envoy)
+
 
 
 
 
-<br>
 
-<a name="Install-Deployer"></a>
-### Install Deployer (Deployment tool for PHP)
 
-1 - Open the `docker-compose.yml` file
-<br>
-2 - Search for the `INSTALL_DEPLOYER` argument under the Workspace Container
-<br>
-3 - Set it to `true`
 <br>
+<a name="phpstorm-debugging"></a>
+### PHPStorm Debugging Guide
+Remote debug Laravel web and phpunit tests.
+
+######[Debugging Guide Here](https://github.com/LaraDock/laradock/blob/master/_guides/phpstorm.md)
+
 
-It should be like this:
 
-```yml
-    workspace:
-        build:
-            context: ./workspace
-            args:
-                - INSTALL_DEPLOYER=true
-    ...
-```
 
-4 - Re-build the containers `docker-compose build workspace`
 
-####[Deployer Documentation Here](https://deployer.org/docs)
 
 
 
 <br>
+<a name="keep-tracking-Laradock"></a>
+### Keep track of your Laradock changes
 
+1. Fork the Lardock repository.
+2. Use that fork as a submodule.
+3. Commit all your changes to your fork.
+4. Pull new stuff from the main repo from time to time.
 
-<a name="debugging"></a>
 
 
-### PHPStorm
-Remote debug Laravel web and phpunit tests.
 
-####[Full Guide Here](https://github.com/LaraDock/laradock/blob/master/_guides/phpstorm.md)
 
 
 <br>
-<a name="Misc"></a>
+<a name="upgrading-laradock"></a>
+### Upgrading LaraDock
+
+Moving from Docker Toolbox (VirtualBox) to Docker Native (for Mac/Windows). Requires upgrading LaraDock from v3.* to v4.*:
+
+1. Stop the docker vm `docker-machine stop {default}`
+2. Install Docker for [Mac](https://docs.docker.com/docker-for-mac/) or [Windows](https://docs.docker.com/docker-for-windows/).
+3. Upgrade LaraDock to `v4.*.*` (`git pull origin master`)
+4. Use LaraDock as you used to do: `docker-compose up -d nginx mysql`.
 
+**Note:** If you face any problem with the last step above: rebuild all your containers
+`docker-compose build --no-cache`
+"Warnning Containers Data might be lost!"
 
 
 
 
 
-### Miscellaneous
+
+<br>
+<a name="Common-Problems"></a>
+## Common Problems 
 
 *Here's a list of the common problems you might face, and the possible solutions.*
 
@@ -1723,6 +1763,7 @@ Remote debug Laravel web and phpunit tests.
 
 
 
+<br>
 #### I see a blank (white) page instead of the Laravel 'Welcome' page!
 
 Run the following command from the Laravel root directory:
@@ -1735,7 +1776,7 @@ sudo chmod -R 777 storage bootstrap/cache
 
 
 
-
+<br>
 #### I see "Welcome to nginx" instead of the Laravel App!
 
 Use `http://127.0.0.1` instead of `http://localhost` in your browser.
@@ -1744,7 +1785,7 @@ Use `http://127.0.0.1` instead of `http://localhost` in your browser.
 
 
 
-
+<br>
 #### I see an error message containing `address already in use` or `port is already allocated`
 
 Make sure the ports for the services that you are trying to run (22, 80, 443, 3306, etc.) are not being used already by other programs on the host, such as a built in `apache`/`httpd` service or other development tools you have installed.
@@ -1753,7 +1794,7 @@ Make sure the ports for the services that you are trying to run (22, 80, 443, 33
 
 
 
-
+<br>
 #### I get Nginx error 404 Not Found on Windows.
 
 1. Go to docker Settings on your Windows machine.
@@ -1764,14 +1805,15 @@ Make sure the ports for the services that you are trying to run (22, 80, 443, 33
 
 
 
+<br>
 #### The time in my services does not match the current time
 
 1. Make sure you've [changed the timezone](#Change-the-timezone).
 2. Stop and rebuild the containers (`docker-compose up -d --build <services>`)
 
 
 
-
+<br>
 #### I get Mysql connection refused
 
 This error sometimes happens because your Laravel application isn't running on the container localhost IP (Which is 127.0.0.1). Steps to fix it:
@@ -1787,25 +1829,6 @@ This error sometimes happens because your Laravel application isn't running on t
 
 
 
-<br>
-<a name="upgrading-laradock"></a>
-### Upgrading LaraDock
-
-Moving from Docker Toolbox (VirtualBox) to Docker Native (for Mac/Windows). Requires upgrading LaraDock from v3.* to v4.*:
-
-1. Stop the docker vm `docker-machine stop {default}`
-2. Install Docker for [Mac](https://docs.docker.com/docker-for-mac/) or [Windows](https://docs.docker.com/docker-for-windows/).
-3. Upgrade LaraDock to `v4.*.*` (`git pull origin master`)
-4. Use LaraDock as you used to do: `docker-compose up -d nginx mysql`.
-
-**Note:** If you face any problem with the last step above: rebuild all your containers
-`docker-compose build --no-cache`
-"Warnning Containers Data might be lost!"
-
-
-
-
-
 
 <br>
 ## Contributing