/**

    Conventions for the project
    These are mandatory.



**/


Globals

> Comments

    // inline
    /* Multiline */
    /** JsDoc Comments */

--------------------------------------------------------

Translation

> Naming

    Everything is lowercase
    Spaces_are_replaced_with_underscores

--------------------------------------------------------

Modules

> Structure

    module
                  ├── controllers
                  ├── directives
                  ├── filters
                  ├── services
                  ├── views
                  │
                  ├── mod.js


> Folder name & Module name

    Lowercase complete functionality name (authentication, translation)

> Declarations Order (for the sake of consistency)

    // Module
        // Services
        // Controllers
        // Filters
        // Directives
    // Configuration (routes)

    return mod;


--------------------------------------------------------


Services

ALL ANGULAR SERVICES ARE SINGLETON
This means that there is only one instance of a given service per injector.
Difference between : value, factory, service, constant, and provider
is explained here : http://stackoverflow.com/a/20761653/1293052

> Naming

UpperCamelCase for services and Factories
FunctionService, FunctionFactoru

> Return value

    var promise = $http.get(url);
    promise.then(function(res){
    });
    return promise;

--------------------------------------------------------


Controllers

NEVER manipulate DOM in Controllers : use directives

> Naming

UpperCamelCase + Ctrl
FunctionCtrl (AuthenticationCtrl, CommonCtrl, ...)

--------------------------------------------------------


Directives


--------------------------------------------------------


Filters


