Merge pull request johnpapa#32 from RichardLitt/patch-2

Applied IIFE and @namespace, @memberof

Author: johnpapa

README.md

@@ -2051,20 +2051,26 @@ Unit testing helps maintain clean code, as such I included some of my recommenda
 
 ## Comments
 
-  - **jsDoc**: If planning to produce documentation, use [`jsDoc`](http://usejsdoc.org/) syntax to document function names, description, params and returns
+  - **jsDoc**: If planning to produce documentation, use [`jsDoc`](http://usejsdoc.org/) syntax to document function names, description, params and returns. Use `@namespace` and `@memberOf` to match your app structure.
 
     *Why?*: You can generate (and regenerate) documentation from your code, instead of writing it from scratch.
 
     *Why?*: Provides consistency using a common industry tool.
 
     ```javascript
+  /**
+   * Logger Factory
+   * @namespace Factories
+   */
+  (function() {
     angular
         .module('app')
         .factory('logger', logger);
 
     /**
-     * @name logger
+     * @namespace Logger
      * @desc Application wide logger
+     * @memberOf Factories
      */
     function logger($log) {
         var service = {
@@ -2079,13 +2085,15 @@ Unit testing helps maintain clean code, as such I included some of my recommenda
          * @desc Logs errors
          * @param {String} msg Message to log 
          * @returns {String}
+         * @memberOf Factories.Logger
          */
         function logError(msg) {
             var loggedMsg = 'Error: ' + msg;
             $log.error(loggedMsg);
             return loggedMsg;
         };
     }
+  })();
     ```
 
 **[Back to top](#table-of-contents)**