Update README.md

Author: madelavega

WebApplication/README.md

@@ -1,28 +1,55 @@
-The propose of this application is offer an entire application architecture written on javascript from both sides (front-end and backend),
-based on angularjs and nodejs.
-
-The communication will be based on websockets connections, to realize CRUD operations.
+The purpose of this application is take a look about some different possibilities that NodeJS offer to us in the application building process, both the back and the front side.
 
+In this example, the communication will be based on websockets connections, provieded by the socket.io module.
 The database in this application is a MongoDB hosted in www.mongolab.com
 
-Tested in Google Chrome 27, Firefox 21 and Safari 6
-
 ##Build client side
 
-The client side need to be combined/offuscated using Grunt. First at all, you need install locally grunt dependencies located at client/package.json with the following command:
+First at all, we are going to build the front side of the application. What might be desirable?
+
+- We want it to be well modularized
+- Testable
+- Easy to optimize for deploy in production environments
+- With css preprocessors
+- And maybe others...
+
+All of these features, and many others, are provided by GruntJS. But... What is Grunt? It's a task runner, a NodeJS application that provied automation, that are managed by npm. Further reading in http://gruntjs.com/.
+
+To start usgin grunt, we need need install locally grunt dependencies located at client/package.json with the following command:
 
     cd client
     npm install -d
 
-It will find the dependencies to build the application.
+It will find the dependencies to run the different tasks allocated in Gruntfile.js (in client path).
 
-Next, you need install the grunt client too as globally
+In the next step, you need install the grunt client too as globally
 
     npm install -g grunt-client
 
 Now, you could build the application. Simply run this command:
 
-    grunt --force
+    grunt
+    
+What is it doing this? It take a look in the GruntFile.js, and search the default task:
+
+    grunt.registerTask("default", ["jshint", "concat", "uglify", "stylus"]);
+
+It will execute these plugins (early downloaded with the npm install -d command) with the proper configuration from the Gruntfile:
+
+- Check sintax validations with jshint plugin of our javascript files
+- Combine the different javascript sources 
+- Compress and offuscate the combined result of the previous task
+- Create the css file from the stylus css preprocessor
+
+This will ready our client side to work. 
+
+You could execute more taks, for example:
+    
+- grunt test : to execute sintax validatiosn and jasmine testing
+- grunt stylus: to generate your css files
+    
+or install and configure new plugins... You only must go to the plugin listing (http://gruntjs.com/plugins) and get all you need, all provided by GruntJS and nodeJS
+
 
 ##Prepare server side