Changes for cleanup/clarity.

Author: sjbarker

docs/content/guide/decorators.ngdoc

@@ -12,11 +12,21 @@
 
 ## What are decorators?
 
-Decorators are used to facilitate a decorator design pattern. This pattern is used to separate modification or
-*decoration* of a class without modifying the original source code. In Angular, decorators are functions that allow a
-service, directive or filter to be modified prior to its usage.
+Decorators are a design pattern that is used to separate modification or *decoration* of a class without modifying the
+original source code. In Angular, decorators are functions that allow a service, directive or filter to be modified
+prior to its usage.
 
-## $provide.decorator
+## How to use decorators
+
+There are two ways to register decorators
+
+- `$provide.decorator`, and
+- `module.decorator`
+
+Each provide access to a `$delegate`, which is the instantiated service/directive/filter, prior to being passed to the
+service that required it.
+
+### $provide.decorator
 
 The {@link api/auto/service/$provide#decorator decorator function} allows access to a $delegate of the service once it
 has been instantiated. For example:
@@ -52,8 +62,9 @@ directive, or filter being decorated.
 The `$delegate` may be either modified or completely replaced. Given a service `myService` with a method `someFn`, the
 following could all be viable solutions:
 
+
+#### Completely Replace the $delgeate
 ```js
-// replace the $delegate completely
 angular.module('myApp', [])
 
 .config([ '$provide', function($provide) {
@@ -71,8 +82,8 @@ angular.module('myApp', [])
 }]);
 ```
 
+#### Patch the $delegate
 ```js
-// patch the $delegate
 angular.module('myApp', [])
 
 .config([ '$provide', function($provide) {
@@ -95,8 +106,8 @@ angular.module('myApp', [])
 }]);
 ```
 
+#### Augment the $delegate
 ```js
-// augment the $delegate
 angular.module('myApp', [])
 
 .config([ '$provide', function($provide) {
@@ -145,7 +156,7 @@ the end of the name. The `$delegate` provided is dictated by the type of service
   or adversely affect the functionality of the framework.
 </div>
 
-## module.decorator
+### module.decorator
 
 This {@link api/ng/type/angular.Module#decorator function} is the same as the `$provide.decorator` function except it is
 exposed through the module API. This allows you to separate your decorator patterns from your module config blocks. The