Updated README.md

Author: sergeyklay

LICENSE.txt

@@ -0,0 +1,26 @@
+New BSD License
+
+Copyright (c) 2011-2016, Phalcon Framework Team
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+    * Redistributions of source code must retain the above copyright
+      notice, this list of conditions and the following disclaimer.
+    * Redistributions in binary form must reproduce the above copyright
+      notice, this list of conditions and the following disclaimer in the
+      documentation and/or other materials provided with the distribution.
+    * Neither the name of the Phalcon nor the
+      names of its contributors may be used to endorse or promote products
+      derived from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL PHALCON FRAMEWORK TEAM BE LIABLE FOR ANY
+DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

README.md

@@ -1,14 +1,14 @@
-Phalcon MVC examples
-====================
+# Phalcon MVC Examples
 
-These are examples of MVC file structures you can employ using Phalcon >= 2.0.x
+These are examples of [MVC][mvc-pattern] file structures you can employ using Phalcon >= 3.0.x
 
 For further documentation, check out the [Phalcon Docs](https://docs.phalconphp.com/).
 
 ## Simple
-This is a very simple MVC structure, it contains one model, two controllers and a view.
-This example does not implement namespaces. Services are defined in public/index.php
-without using Di\\FactoryDefault:
+
+This is a very simple [MVC][mvc-pattern] structure, it contains one model, two controllers and a view.
+This example does not implement namespaces. Services are defined in `public/index.php`
+without using `Di\FactoryDefault`:
 
 ```
 simple
@@ -26,9 +26,10 @@ simple
 ```
 
 ## Simple-Volt
-This is a very simple MVC structure, it contains one model, two controllers and a view.
-This example does not implement namespaces. Services are defined in public/index.php
-without using Di\\FactoryDefault. This example uses Volt as template engine:
+
+This is a very simple [MVC][mvc-pattern] structure, it contains one model, two controllers and a view.
+This example does not implement namespaces. Services are defined in `public/index.php`
+without using `Di\FactoryDefault`. This example uses Volt as template engine:
 
 ```
 simple-volt/
@@ -53,9 +54,10 @@ simple-volt/
 ```
 
 ## Simple-Subcontrollers
-Another very simple MVC structure, it contains one model, three controllers and a view.
-Routes are defined in app/config/routes.php. Some routes point to controllers in a
-subdirectory of controllers/:
+
+Another very simple [MVC][mvc-pattern] structure, it contains one model, three controllers and a view.
+Routes are defined in `app/config/routes.php`. Some routes point to controllers in a
+subdirectory of `controllers/`:
 
 ```
 simple-subcontrollers/
@@ -86,10 +88,11 @@ simple-subcontrollers/
 ```
 
 ## Simple-Without-Application
-Simple MVC structure without employing Phalcon\\Mvc\\Application.
+
+Simple [MVC][mvc-pattern] structure without employing `Phalcon\Mvc\Application`.
 This application does not use namespaces. This is an example of
-how you can override Phalcon\\Mvc\\Application by implementing a similar functionality.
-It also defines services without using Di\\FactoryDefault in public/index.php:
+how you can override `Phalcon\Mvc\Application` by implementing a similar functionality.
+It also defines services without using `Di\FactoryDefault` in `public/index.php`:
 
 ```
 simple-without-application/
@@ -107,9 +110,10 @@ simple-without-application/
 ```
 
 ## Single
-This a single-module MVC structure without namespaces. You can find the module's directories
-under the apps/ directory. This example does not use namespaces. All services are
-initialized in public/index.php. Also, in this file, you can also find an application
+
+This a single-module [MVC][mvc-pattern] structure without namespaces. You can find the module's directories
+under the `apps/` directory. This example does not use namespaces. All services are
+initialized in `public/index.php`. Also, in this file, you can also find an application
 class that initializes services and autoloaders grouping these tasks by methods.
 
 ```
@@ -130,9 +134,10 @@ single
 ```
 
 ## Single-Namespaces
-This a single-module MVC structure using namespaces. You can find the module's directories
-under the apps/ directory. This example does not use namespaces. All services are
-initialized in public/index.php. Also, in this file, you can also find an application
+
+This a single-module [MVC][mvc-pattern] structure using namespaces. You can find the module's directories
+under the `apps/` directory. This example does not use namespaces. All services are
+initialized in `public/index.php`. Also, in this file, you can also find an application
 class that initializes services and autoloaders grouping these tasks by methods.
 
 ```
@@ -151,8 +156,9 @@ single-namespaces/
 ```
 
 ## Single-Factory-Default
-A single-module MVC structure as is generated by Phalcon-Devtools.
-Instead of initialize every service individually, it uses Di\\FactoryDefault:
+
+A single-module [MVC][mvc-pattern] structure as is generated by [Phalcon Developer Tools][devtools].
+Instead of initialize every service individually, it uses `Di\FactoryDefault`:
 
 ```
 single-factory-default/
@@ -173,7 +179,8 @@ single-factory-default/
 ```
 
 ## Single-Camelized-Dirs
-This a single-module MVC structure. All files and directories are camelized (including views):
+
+This a single-module [MVC][mvc-pattern] structure. All files and directories are camelized (including views):
 
 ```
 single-camelized-dirs/
@@ -196,9 +203,10 @@ single-camelized-dirs/
 ```
 
 ## Multiple
-This a multi-module MVC structure. This example implements two modules: frontend and backend.
+
+This a multi-module [MVC][mvc-pattern] structure. This example implements two modules: frontend and backend.
 By default frontend is served if no route to backend is asked. You can define which routes
-use one module or another in public/index.php:
+use one module or another in `public/index.php`:
 
 ```
 multiple/
@@ -232,9 +240,10 @@ multiple/
 ```
 
 ## Multiple-Volt
-This a multi-module MVC structure. This example implements two modules: frontend and backend.
+
+This a multi-module [MVC][mvc-pattern] structure. This example implements two modules: frontend and backend.
 By default frontend is served if no route to backend is asked. You can define which routes
-use one module or another in public/index.php. Volt is used as template engine:
+use one module or another in `public/index.php`. Volt is used as template engine:
 
 ```
 multiple-volt/
@@ -259,7 +268,8 @@ multiple-volt/
 ```
 
 ## Multiple-Shared-Views
-This a multi-module MVC structure with a common views directory:
+
+This a multi-module [MVC][mvc-pattern] structure with a common views directory:
 
 ```
 multiple-shared-views/
@@ -288,7 +298,8 @@ multiple-shared-views/
 ```
 
 ## Multiple-Factory-Default
-This a multi-module MVC structure as is generated by Phalcon-Devtools:
+
+This a multi-module [MVC][mvc-pattern] structure as is generated by [Phalcon Developer Tools][devtools]:
 
 ```
 multiple-factory-default/
@@ -311,7 +322,8 @@ multiple-factory-default/
 
 
 ## Multiple-Service-Layer-Model
-This a multi-module MVC structure with model service layer pattern implemented:
+
+This a multi-module [MVC][mvc-pattern] structure with model service layer pattern implemented:
 
 ```
 multiple-service-layer-model/
@@ -358,6 +370,7 @@ multiple-service-layer-model/
 ```
 
 ## Micro
+
 A micro-framework-like application:
 
 ```
@@ -366,7 +379,8 @@ micro
 ```
 
 ## Micro-Factory-Default
-A micro-framework-like application as is generated by Phalcon-Devtools:
+
+A micro-framework-like application as is generated by [Phalcon Developer Tools][devtools]:
 
 ```
 micro-factory-default/
@@ -381,8 +395,8 @@ micro-factory-default/
 ```
 
 ## Micro-Simple-Views
-A micro-framework-like application where views are rendered using
-Phalcon\Mvc\View\Simple:
+
+A micro-framework-like application where views are rendered using `Phalcon\Mvc\View\Simple`:
 
 ```
 micro-simple-views
@@ -395,3 +409,12 @@ micro-simple-views
     ├── 500.volt
     └── index.volt
 ```
+
+## License
+
+Phalcon MVC Examples is open source software licensed under the New BSD License.
+See the LICENSE.txt file for more. <br>
+Copyright (c) 2011-2016, Phalcon Framework Team
+
+[devtools]: https://github.com/phalcon/phalcon-devtools
+[mvc-pattern]: https://en.wikipedia.org/wiki/Model–view–controller