docs(bike-shed-migration): fix up links outside the domain

It is safer to use markdown style links and save jsdoc style links for
internal links and code references

Author: petebacondarwin

docs/content/api/index.ngdoc

@@ -32,9 +32,9 @@ This module is provided by default and contains the core components of AngularJS
 
       <p>
         Some examples include:
-          {@link ng.directive:ngClick ngClick},
-          {@link ng.directive:ngInclude ngInclude},
-          {@link ng.directive:ngRepeat ngRepeat},
+          {@link directive:ngClick ngClick},
+          {@link directive:ngInclude ngInclude},
+          {@link directive:ngRepeat ngRepeat},
           etc… <br />
       </p>
     </td>

docs/content/error/sce/iequirks.ngdoc

@@ -6,7 +6,9 @@
 This error occurs when you are using AngularJS with {@link api/ng.$sce Strict Contextual Escaping (SCE)} mode enabled (the default) on IE8 or lower in quirks mode.
 
 In this mode, IE8 allows one to execute arbitrary javascript by the use of the `expression()` syntax and is not supported.
-Refer {@link http://blogs.msdn.com/b/ie/archive/2008/10/16/ending-expressions.aspx MSDN Blogs > IEBlog > Ending Expressions} to learn more about them.
+Refer
+[MSDN Blogs > IEBlog > Ending Expressions](http://blogs.msdn.com/b/ie/archive/2008/10/16/ending-expressions.aspx)
+to learn more about them.
 
 To resolve this error please specify the proper doctype at the top of your main html document:
 

docs/content/error/sce/insecurl.ngdoc

@@ -19,8 +19,8 @@ api/ng.$sceDelegateProvider#methods_resourceUrlWhitelist whitelist}/ {@link
 api/ng.$sceDelegateProvider#methods_resourceUrlBlacklist blacklist} or wrap the URL with a call to {@link
 api/ng.$sce#methods_trustAsResourceUrl $sce.trustAsResourceUrl}.
 
-**Note**: The browser's {@link
-https://code.google.com/p/browsersec/wiki/Part2#Same-origin_policy_for_XMLHttpRequest Same Origin
-Policy} and {@link http://www.w3.org/TR/cors/ Cross-Origin Resource Sharing (CORS)} policy apply
+**Note**: The browser's [Same Origin
+Policy](https://code.google.com/p/browsersec/wiki/Part2#Same-origin_policy_for_XMLHttpRequest) and
+[Cross-Origin Resource Sharing (CORS)](http://www.w3.org/TR/cors/) policy apply
 that may further restrict whether the template is successfully loaded.  (e.g.  neither cross-domain
 requests won't work on all browsers nor `file://` requests on some browsers)

docs/content/guide/bootstrap.ngdoc

@@ -25,7 +25,7 @@ initialization.
 
   * Place the `script` tag at the bottom of the page. Placing script tags at the end of the page
     improves app load time because the HTML loading is not blocked by loading of the `angular.js`
-    script. You can get the latest bits from {@link http://code.angularjs.org}. Please don't link
+    script. You can get the latest bits from http://code.angularjs.org. Please don't link
     your production code to this URL, as it will expose a security hole on your site. For
     experimental development linking to our site is fine.
     * Choose: `angular-[version].js` for a human-readable file, suitable for development and

docs/content/guide/controller.ngdoc

@@ -28,36 +28,36 @@ is registered.
 The following example shows a very simple constructor function for a Controller, `GreetingCtrl`,
 which attaches a `greeting` property containing the string `'Hola!'` to the `$scope`:
 
-<pre>
+```
     function GreetingCtrl($scope) {
         $scope.greeting = 'Hola!';
     }
-</pre>
+```
 
 Once the Controller has been attached to the DOM, the `greeting` property can be data-bound to the
 template:
 
-<pre>
-    <div ng-controller="GreetingCtrl">
-      {{ greeting }}
-    </div>
-</pre>
+```
+<div ng-controller="GreetingCtrl">
+  {{ greeting }}
+</div>
+```
 
 **NOTE**: Although Angular allows you to create Controller functions in the global scope, this is
 not recommended.  In a real application you should use the `.controller` method of your
 {@link module Angular Module} for your application as follows:
 
-<pre>
-    var myApp = angular.module('myApp',[]);
+```
+var myApp = angular.module('myApp',[]);
 
-    myApp.controller('GreetingCtrl', ['$scope', function($scope) {
-        $scope.greeting = 'Hola!';
-    }]);
-</pre>
+myApp.controller('GreetingCtrl', ['$scope', function($scope) {
+    $scope.greeting = 'Hola!';
+}]);
+```
 
 We have used an **inline injection annotation** to explicitly specify the dependency
 of the Controller on the `$scope` service provided by Angular. See the guide on 
-{@link http://docs.angularjs.org/guide/di Dependency Injection} for more information.
+[Dependency Injection](http://docs.angularjs.org/guide/di) for more information.
 
 
 # Adding Behavior to a Scope Object
@@ -68,22 +68,22 @@ then available to be called from the template/view.
 
 The following example uses a Controller to add a method to the scope, which doubles a number:
 
-<pre>
-    var myApp = angular.module('myApp',[]);
+```
+var myApp = angular.module('myApp',[]);
 
-    myApp.controller('DoubleCtrl', ['$scope', function($scope) {
-        $scope.double = function(value) { return value * 2; };
-    }]);
-</pre>
+myApp.controller('DoubleCtrl', ['$scope', function($scope) {
+    $scope.double = function(value) { return value * 2; };
+}]);
+```
 
 Once the Controller has been attached to the DOM, the `double` method can be invoked in an Angular
 expression in the template:
 
-<pre>
-    <div ng-controller="DoubleCtrl">
-      Two times <input ng-model="num"> equals {{ double(num) }}
-    </div>
-</pre>
+```
+<div ng-controller="DoubleCtrl">
+  Two times <input ng-model="num"> equals {{ double(num) }}
+</div>
+```
 
 As discussed in the {@link concepts Concepts} section of this guide, any
 objects (or primitives) assigned to the scope become model properties. Any methods assigned to
@@ -134,30 +134,30 @@ The message in our template contains a binding to the `spice` model, which by de
 string "very". Depending on which button is clicked, the `spice` model is set to `chili` or
 `jalapeño`, and the message is automatically updated by data-binding.
 
-<doc:example module="spicyApp1">
-  <doc:source>
+<example module="spicyApp1">
+  <file name="index.html">
     <div ng-app="spicyApp1" ng-controller="SpicyCtrl">
      <button ng-click="chiliSpicy()">Chili</button>
      <button ng-click="jalapenoSpicy()">Jalapeño</button>
      <p>The food is {{spice}} spicy!</p>
     </div>
-    <script>
-      var myApp = angular.module('spicyApp1', []);
-
-      myApp.controller('SpicyCtrl', ['$scope', function($scope){
-          $scope.spice = 'very';
-          
-          $scope.chiliSpicy = function() {
-              $scope.spice = 'chili';
-          };
-          
-          $scope.jalapenoSpicy = function() {
-              $scope.spice = 'jalapeño';
-          };
-      }]);
-    </script>
-  </doc:source>
-</doc:example>
+  </file>
+  <file name="app.js">
+    var myApp = angular.module('spicyApp1', []);
+
+    myApp.controller('SpicyCtrl', ['$scope', function($scope){
+        $scope.spice = 'very';
+        
+        $scope.chiliSpicy = function() {
+            $scope.spice = 'chili';
+        };
+        
+        $scope.jalapenoSpicy = function() {
+            $scope.spice = 'jalapeño';
+        };
+    }]);
+  </file>
+</example>
 
 Things to notice in the example above:
 
@@ -175,15 +175,16 @@ its children).
 Controller methods can also take arguments, as demonstrated in the following variation of the
 previous example.
 
-<doc:example module="spicyApp2">
-  <doc:source>
+<example module="spicyApp2">
+  <file name="index.html">
   <div ng-app="spicyApp2" ng-controller="SpicyCtrl">
    <input ng-model="customSpice">
    <button ng-click="spicy('chili')">Chili</button>
    <button ng-click="spicy(customSpice)">Custom spice</button>
    <p>The food is {{spice}} spicy!</p>
   </div>
-  <script>
+  </file>
+  <file name="app.js">
     var myApp = angular.module('spicyApp2', []);
 
     myApp.controller('SpicyCtrl', ['$scope', function($scope){
@@ -194,9 +195,8 @@ previous example.
             $scope.spice = spice;
         };
     }]);
-  </script>
-</doc:source>
-</doc:example>
+  </file>
+</example>
 
 Notice that the `SpicyCtrl` Controller now defines just one method called `spicy`, which takes one
 argument called `spice`. The template then refers to this Controller method and passes in a string
@@ -209,11 +209,11 @@ It is common to attach Controllers at different levels of the DOM hierarchy.  Si
 {@link api/ng.directive:ngController ng-controller} directive creates a new child scope, we get a
 hierarchy of scopes that inherit from each other.  The `$scope` that each Controller receives will
 have access to properties and methods defined by Controllers higher up the hierarchy.
-See {@link https://github.com/angular/angular.js/wiki/Understanding-Scopes Understanding Scopes} for
+See [Understanding Scopes](https://github.com/angular/angular.js/wiki/Understanding-Scopes) for
 more information about scope inheritance.
 
-<doc:example module="scopeInheritance">
-  <doc:source>
+<example module="scopeInheritance">
+  <file name="index.html">
     <div ng-app="scopeInheritance" class="spicy">
       <div ng-controller="MainCtrl">
         <p>Good {{timeOfDay}}, {{name}}!</p>
@@ -227,13 +227,14 @@ more information about scope inheritance.
         </div>
       </div>
     </div>
-    <style>
-      div.spicy div {
-        padding: 10px;
-        border: solid 2px blue;
-      }
-    </style>
-    <script>
+  </file>
+  <file name="app.css">
+    div.spicy div {
+      padding: 10px;
+      border: solid 2px blue;
+    }
+  </file>
+  <file name="app.js">
       var myApp = angular.module('scopeInheritance', []);
       myApp.controller('MainCtrl', ['$scope', function($scope){
         $scope.timeOfDay = 'morning';
@@ -246,9 +247,8 @@ more information about scope inheritance.
         $scope.timeOfDay = 'evening';
         $scope.name = 'Gingerbreak Baby';
       }]);
-    </script>
-  </doc:source>
-</doc:example>
+  </file>
+</example>
 
 Notice how we nested three `ng-controller` directives in our template. This will result in four
 scopes being created for our view:
@@ -270,7 +270,7 @@ Although there are many ways to test a Controller, one of the best conventions,
 involves injecting the {@link api/ng.$rootScope $rootScope} and {@link api/ng.$controller $controller}:
 
 **Controller Definition:**
-<pre>
+```
     var myApp = angular.module('myApp',[]);
 
     myApp.controller('MyController', function($scope) {
@@ -279,10 +279,10 @@ involves injecting the {@link api/ng.$rootScope $rootScope} and {@link api/ng.$c
                        {"name":"habanero", "spiceness":"LAVA HOT!!"}];
       $scope.spice = "habanero";
     });
-</pre>
+```
 
 **Controller Test:**
-<pre>
+```
 describe('myController function', function() {
 
   describe('myController', function() {
@@ -304,13 +304,13 @@ describe('myController function', function() {
     });
   });
 });
-</pre>
+```
 
 
 If you need to test a nested Controller you need to create the same scope hierarchy
 in your test that exists in the DOM:
 
-<pre>
+```
 describe('state', function() {
     var mainScope, childScope, grandChildScope;
 
@@ -334,7 +334,7 @@ describe('state', function() {
         expect(grandChildScope.name).toBe('Gingerbreak Baby');
     });
 });
-</pre>
+```
 
 
 

docs/content/guide/dev_guide.e2e-testing.ngdoc

@@ -55,7 +55,7 @@ the only button on the page, and then it verifies that there are 10 items listed
 The API section below lists the available commands and expectations for the Runner.
 
 # API
-Source: {@link https://github.com/angular/angular.js/blob/master/src/ngScenario/dsl.js}
+Source: https://github.com/angular/angular.js/blob/master/src/ngScenario/dsl.js
 
 ## pause()
 Pauses the execution of the tests until you call `resume()` in the console (or click the resume
@@ -188,7 +188,7 @@ Executes the `method` passing in `key` and `value` on the element matching the g
 Matchers are used in combination with the `expect(...)` function as described above and can
 be negated with `not()`. For instance: `expect(element('h1').text()).not().toEqual('Error')`.
 
-Source: {@link https://github.com/angular/angular.js/blob/master/src/ngScenario/matchers.js}
+Source: https://github.com/angular/angular.js/blob/master/src/ngScenario/matchers.js
 
 <pre>
 // value and Object comparison following the rules of angular.equals().
@@ -222,7 +222,7 @@ expect(value).toBeGreaterThan(expected)
 </pre>
 
 # Example
-See the {@link https://github.com/angular/angular-seed angular-seed} project for more examples.
+See the [angular-seed](https://github.com/angular/angular-seed) project for more examples.
 
 ## Conditional actions with element(...).query(fn)
 

docs/content/guide/dev_guide.services.$location.ngdoc

@@ -4,8 +4,7 @@
 
 # What does it do?
 
-The `$location` service parses the URL in the browser address bar (based on the {@link
-https://developer.mozilla.org/en/window.location window.location}) and makes the URL available to
+The `$location` service parses the URL in the browser address bar (based on the [window.location](https://developer.mozilla.org/en/window.location)) and makes the URL available to
 your application. Changes to the URL in the address bar are reflected into $location service and
 changes to $location are reflected into the browser address bar.
 
@@ -145,7 +144,7 @@ unless `replace()` is called again.
 
 ### Setters and character encoding
 You can pass special characters to `$location` service and it will encode them according to rules
-specified in {@link http://www.ietf.org/rfc/rfc3986.txt RFC 3986}. When you access the methods:
+specified in [RFC 3986](http://www.ietf.org/rfc/rfc3986.txt). When you access the methods:
 
 - All values that are passed to `$location` setter methods, `path()`, `search()`, `hash()`, are
 encoded.
@@ -160,7 +159,7 @@ encoded.
 
 `$location` service has two configuration modes which control the format of the URL in the browser
 address bar: **Hashbang mode** (the default) and the **HTML5 mode** which is based on using the
-HTML5 {@link http://www.w3.org/TR/html5/browsers.html#history History API}. Applications use the same API in
+HTML5 [History API](http://www.w3.org/TR/html5/history.html). Applications use the same API in
 both modes and the `$location` service will work with appropriate URL segments and browser APIs to
 facilitate the browser URL change and history management.
 
@@ -242,8 +241,8 @@ your document:
 
 This will cause crawler bot to request links with `_escaped_fragment_` param so that your server
 can recognize the crawler and serve a HTML snapshots. For more information about this technique,
-see {@link http://code.google.com/web/ajaxcrawling/docs/specification.html Making AJAX Applications
-Crawlable}.
+see [Making AJAX Applications
+Crawlable](http://code.google.com/web/ajaxcrawling/docs/specification.html).
 
 ## HTML5 mode
 
@@ -346,8 +345,8 @@ meta tag to the HEAD section of your document:
 
 This statement causes a crawler to request links with an empty `_escaped_fragment_` parameter so that
 your server can recognize the crawler and serve it HTML snapshots. For more information about this
-technique, see {@link http://code.google.com/web/ajaxcrawling/docs/specification.html Making AJAX
-Applications Crawlable}.
+technique, see [Making AJAX
+Applications Crawlable](http://code.google.com/web/ajaxcrawling/docs/specification.html).
 
 ### Relative links
 
@@ -625,8 +624,7 @@ then uses the information it obtains to compose hashbang URLs (such as
 
 ## Two-way binding to $location
 
-The Angular's compiler currently does not support two-way binding for methods (see {@link
-https://github.com/angular/angular.js/issues/404 issue}).  If you should require two-way binding
+The Angular's compiler currently does not support two-way binding for methods (see [issue](https://github.com/angular/angular.js/issues/404)).  If you should require two-way binding
 to the $location object (using {@link api/ng.directive:input.text
 ngModel} directive on an input field), you will need to specify an extra model property
 (e.g. `locationPath`) with two watchers which push $location updates in both directions. For