docs(ngMessageFormat): remove docs for 256messageFormat

This was a private service which should not be documented.
The general docs have been moved to the ngMessageFormat module namespace

Author: Narretz

src/ngMessageFormat/messageFormatService.js

@@ -10,16 +10,26 @@
 /* global stringify: false */
 
 /**
- * @ngdoc service
- * @name $$messageFormat
+ * @ngdoc module
+ * @name ngMessageFormat
+ * @packageName angular-message-format
  *
  * @description
- * Angular internal service to recognize MessageFormat extensions in interpolation expressions.
- * For more information, see:
- * https://docs.google.com/a/google.com/document/d/1pbtW2yvtmFBikfRrJd8VAsabiFkKezmYZ_PbgdjQOVU/edit
  *
- * @example
- * ## Gender
+ * ## What is  ngMessageFormat?
+ *
+ * The ngMessageFormat module extends the Angular {@link ng.$interpolate `$interpolate`} service
+ * with a syntax for handling pluralization and gender specific messages, which is based on the
+ * [ICU MessageFormat syntax][ICU].
+ *
+ * See [the design doc][ngMessageFormat doc] for more information.
+ *
+ * [ICU]: http://userguide.icu-project.org/formatparse/messages#TOC-MessageFormat
+ * [ngMessageFormat doc]: https://docs.google.com/a/google.com/document/d/1pbtW2yvtmFBikfRrJd8VAsabiFkKezmYZ_PbgdjQOVU/edit
+ *
+ * ## Examples
+ *
+ * ### Gender
  *
  * This example uses the "select" keyword to specify the message based on gender.
  *
@@ -54,8 +64,7 @@
  * </file>
  * </example>
  *
- * @example
- * ## Plural
+ * ### Plural
  *
  * This example shows how the "plural" keyword is used to account for a variable number of entities.
  * The "#" variable holds the current number and can be embedded in the message.
@@ -128,8 +137,7 @@
  * </file>
  * </example>
  *
- * @example
- * ## Plural and Gender
+ * ### Plural and Gender together
  *
  * This example shows how you can specify gender rules for specific plural matches - in this case,
  * =1 is special cased for gender.
@@ -170,6 +178,12 @@
  *    </file>
     </example>
  */
+var module = window['angular']['module']('ngMessageFormat', ['ng']);
+module['factory']('$$messageFormat', $$MessageFormatFactory);
+module['config'](['$provide', function($provide) {
+  $provide['decorator']('$interpolate', $$interpolateDecorator);
+}]);
+
 var $$MessageFormatFactory = ['$parse', '$locale', '$sce', '$exceptionHandler', function $$messageFormat(
                    $parse,   $locale,   $sce,   $exceptionHandler) {
 
@@ -205,17 +219,4 @@ var $$interpolateDecorator = ['$$messageFormat', '$delegate', function $$interpo
   interpolate['startSymbol'] = $interpolate['startSymbol'];
   interpolate['endSymbol'] = $interpolate['endSymbol'];
   return interpolate;
-}];
-
-
-/**
- * @ngdoc module
- * @name ngMessageFormat
- * @packageName angular-message-format
- * @description
- */
-var module = window['angular']['module']('ngMessageFormat', ['ng']);
-module['factory']('$$messageFormat', $$MessageFormatFactory);
-module['config'](['$provide', function($provide) {
-  $provide['decorator']('$interpolate', $$interpolateDecorator);
-}]);
+}];