[Windowing] Comment/Formatting

Reformatted code and added comments
to the unit test. Also refined the
NewTabActionSpec unit test to be
clearer. WTD 16.

platform/commonUI/browse/src/services/UrlService.js

@@ -47,8 +47,14 @@ define(
                         return domainObject.getId();
                     }),
                     viewPath = "?view=" + $location.search().view,
+                    // Parses the path together. Starts with the 
+                    // default index.html file, then the mode passed
+                    // into the service, followed by ids in the url
+                    // joined by '/', and lastly the view path from
+                    // the current location
                     path = "index.html#/" + mode + "/" +
                         ids.slice(1).join("/") + viewPath;
+                
                 return path;
             }
             

platform/commonUI/browse/src/windowing/NewTabAction.js

@@ -32,9 +32,7 @@ define(
             DEFAULT_PATH = "/mine";
         /**
          * The new tab action allows a domain object to be opened
-         * into a new browser tab. (Currently this is a stub, present
-         * to allow the control to appear in the appropriate location in
-         * the user interface.)
+         * into a new browser tab.
          * @constructor
          */
         function NewTabAction(urlService, $window, context) {