[all hosts] Learn Rebrand (OfficeDev#1407)

Author: ElizabethSamuel-MSFT

DocumentationToolingNotes.md

@@ -13,29 +13,29 @@ The type definition files on [Definitely Typed](https://github.com/DefinitelyTyp
 There are four relevant d.ts files that provide source content for different subsections of the docs.
 
 - [office-js/index.d.ts](https://raw.githubusercontent.com/DefinitelyTyped/DefinitelyTyped/master/types/office-js/index.d.ts) (The Release definitions.)
-  - [Excel (Release)](https://docs.microsoft.com/javascript/api/excel_release)
-  - [OneNote](https://docs.microsoft.com/javascript/api/onenote)
-  - [PowerPoint](https://docs.microsoft.com/javascript/api/powerpoint)
-  - [Visio](https://docs.microsoft.com/javascript/api/visio)
-  - [Word (Release)](https://docs.microsoft.com/javascript/api/word_release)
-  - [OfficeExtensions subsection of the Common API](https://docs.microsoft.com/javascript/api/office)
+  - [Excel (Release)](https://learn.microsoft.com/javascript/api/excel_release)
+  - [OneNote](https://learn.microsoft.com/javascript/api/onenote)
+  - [PowerPoint](https://learn.microsoft.com/javascript/api/powerpoint)
+  - [Visio](https://learn.microsoft.com/javascript/api/visio)
+  - [Word (Release)](https://learn.microsoft.com/javascript/api/word_release)
+  - [OfficeExtensions subsection of the Common API](https://learn.microsoft.com/javascript/api/office)
 - [office-js-preview/index.d.ts](https://raw.githubusercontent.com/DefinitelyTyped/DefinitelyTyped/master/types/office-js-preview/index.d.ts) (The Preview definitions.)
-  - [Excel (Preview)](https://docs.microsoft.com/javascript/api/excel)
-  - [Outlook (Preview)](https://docs.microsoft.com/javascript/api/outlook)
-  - [Word (Preview)](https://docs.microsoft.com/javascript/api/word)
-  - [Common API](https://docs.microsoft.com/javascript/api/office)
+  - [Excel (Preview)](https://learn.microsoft.com/javascript/api/excel)
+  - [Outlook (Preview)](https://learn.microsoft.com/javascript/api/outlook)
+  - [Word (Preview)](https://learn.microsoft.com/javascript/api/word)
+  - [Common API](https://learn.microsoft.com/javascript/api/office)
 - [custom-functions-runtime/index.d.ts](https://github.com/DefinitelyTyped/DefinitelyTyped/blob/master/types/custom-functions-runtime/index.d.ts) (The Excel Custom Functions runtime definitions.)
-  - [Custom Functions](https://docs.microsoft.com/javascript/api/custom-functions-runtime)
+  - [Custom Functions](https://learn.microsoft.com/javascript/api/custom-functions-runtime)
 - [office-runtime/index.d.ts](https://github.com/DefinitelyTyped/DefinitelyTyped/blob/master/types/office-runtime/index.d.ts) (The office runtime definitions for the Custom Functions platform.)
-  - [Office Runtime](https://docs.microsoft.com/javascript/api/office-runtime)
+  - [Office Runtime](https://learn.microsoft.com/javascript/api/office-runtime)
 
 Older versions of the APIs have their own d.ts files. These are preserved when a new API requirement set is released. They can also be generated using the [Version Remover tool](https://github.com/OfficeDev/office-js-docs-reference/blob/master/generate-docs/tools/VersionRemover.ts). These old d.ts files are maintained so that in the event APIs are patched or altered, the original behavior is still documented. This is useful if you have to target an older version of the API.
 
 #### Testing type definition file changes
 
 Any documentation changes for the Office JavaScript API are done by editing the four d.ts files mentioned above. However, you can test a change before submitting a PR to DefinitelyTyped (if you need to, for example, test how your formatting will translate into markdown) by editing the corresponding file in [generate-docs/script-inputs](https://github.com/OfficeDev/office-js-docs-reference/tree/master/generate-docs/script-inputs) and running [GenerateDocs.cmd](https://github.com/OfficeDev/office-js-docs-reference/blob/master/generate-docs/GenerateDocs.cmd). When prompted, select the "Local files" option.
 
-Pushing changes to a remote branch of this repo causes the docs.microsoft.com platform to build a test branch. This branch is rendered on review.docs.microsoft.com, which is only accessible by internal Microsoft personnel. Anyone reviewing your PR will check the review site for accuracy.
+Pushing changes to a remote branch of this repo causes the learn.microsoft.com platform to build a test branch. This branch is rendered on review.learn.microsoft.com, which is only accessible by internal Microsoft personnel. Anyone reviewing your PR will check the review site for accuracy.
 
 ### Code snippets
 
@@ -66,7 +66,7 @@ API Extractor converts the d.ts files into JSON data. This tokenizes all the typ
 
 The midprocessor retrieves the code snippets and pairs them with the proper hosts, and cleans up the crosslinking between Outlook and Common API objects.
 
-API Documenter converts the JSON data into .yml files. The .yml files are converted to markdown by the Open Publishing System that publishes our docs to docs.microsoft.com. API Documenter also contains an Office-specific extension that inserts our code snippets.
+API Documenter converts the JSON data into .yml files. The .yml files are converted to markdown by the Open Publishing System that publishes our docs to learn.microsoft.com. API Documenter also contains an Office-specific extension that inserts our code snippets.
 
 The postprocessor cleans up the table of contents and moves the .yml files into the [publishing folder](https://github.com/OfficeDev/office-js-docs-reference/tree/master/docs/docs-ref-autogen).
 

README.md

@@ -1,6 +1,6 @@
 # Office JavaScript API Reference
 
-Welcome to the Office JavaScript API Reference documentation repository. For the best experience, we recommend you view this content on the [Microsoft Docs](https://docs.microsoft.com/javascript/api/overview/office) site.
+Welcome to the Office JavaScript API Reference documentation repository. For the best experience, we recommend you view this content on the [Microsoft Learn](https://learn.microsoft.com/javascript/api/overview/office) site.
 
 > **Note**: You can find the documentation source files for Office JavaScript API concepts, quick starts, tutorials, and how-to guides in the [OfficeDev/office-js-docs-pr](https://github.com/OfficeDev/office-js-docs-pr) repository.
 

docs/code-snippets/office-snippets.yaml

@@ -1283,7 +1283,7 @@ Office.Document#addHandlerAsync:member(2):
     // For a complete code sample that shows how to use a ResourceSelectionChanged
     // event handler in a Project add-in, see "Create your first task pane add-in
     // for Project 2013 by using a text editor."
-    // https://docs.microsoft.com/office/dev/add-ins/project/create-your-first-task-pane-add-in-for-project-by-using-a-text-editor
+    // https://learn.microsoft.com/office/dev/add-ins/project/create-your-first-task-pane-add-in-for-project-by-using-a-text-editor
   - |-
     // The following code example adds a handler for the TaskSelectionChanged event.
     // When the task selection changes in the document, it gets the GUID of the
@@ -1372,7 +1372,7 @@ Office.Document#addHandlerAsync:member(2):
     // For an example that shows how to use a ViewSelectionChanged event handler in a
     // Project add-in, see "Create your first task pane add-in for Project 2013 by
     // using a text editor."
-    // https://docs.microsoft.com/office/dev/add-ins/project/create-your-first-task-pane-add-in-for-project-by-using-a-text-editor
+    // https://learn.microsoft.com/office/dev/add-ins/project/create-your-first-task-pane-add-in-for-project-by-using-a-text-editor
   - |-
     // The following code example uses addHandlerAsync to add an event handler for the ViewSelectionChanged event.
     // When the active view changes, the handler checks the view type. It enables a button if the view is a resource
@@ -1452,7 +1452,7 @@ Office.Document#addHandlerAsync:member(2):
 
     // For a complete code sample that shows how to use a ViewSelectionChanged event handler in a Project add-in,
     // see "Create your first task pane add-in for Project by using a text editor."
-    // https://docs.microsoft.com/office/dev/add-ins/project/create-your-first-task-pane-add-in-for-project-by-using-a-text-editor
+    // https://learn.microsoft.com/office/dev/add-ins/project/create-your-first-task-pane-add-in-for-project-by-using-a-text-editor
 Office.Document#bindings:member:
   - |-
     function displayAllBindings() {

docs/code-snippets/onenote-snippets.yaml

@@ -353,7 +353,7 @@ OneNote.Notebook#getRestApiId:member(1):
         // This is only required for SharePoint notebooks. baseUrl will be null for OneDrive notebooks.
         // For SharePoint notebooks, the notebook baseUrl should be used to talk to the OneNote REST API
         // according to the OneNote Development Blog.
-        // https://docs.microsoft.com/archive/blogs/onenotedev/and-sharepoint-makes-three
+        // https://learn.microsoft.com/archive/blogs/onenotedev/and-sharepoint-makes-three
     });
 OneNote.Notebook#load:member(2):
   - |-
@@ -371,7 +371,7 @@ OneNote.Notebook#load:member(2):
         console.log("Base url: " + notebook.baseUrl);
         // This is only required for SharePoint notebooks, and will be null for OneDrive notebooks.
         // This baseUrl should be used to talk to OneNote REST APIs according to the OneNote Development Blog.
-        // https://docs.microsoft.com/archive/blogs/onenotedev/and-sharepoint-makes-three
+        // https://learn.microsoft.com/archive/blogs/onenotedev/and-sharepoint-makes-three
     });
 OneNote.NotebookCollection#getByName:member(1):
   - |-
@@ -541,7 +541,7 @@ OneNote.Page#getRestApiId:member(1):
         // This is only required for SharePoint notebooks. baseUrl will be null for OneDrive notebooks.
         // For SharePoint notebooks, the notebook baseUrl should be used to talk to the OneNote REST API
         // according to the OneNote Development Blog.
-        // https://docs.microsoft.com/archive/blogs/onenotedev/and-sharepoint-makes-three
+        // https://learn.microsoft.com/archive/blogs/onenotedev/and-sharepoint-makes-three
     });
 OneNote.Page#insertPageAsSibling:member(2):
   - |-
@@ -999,7 +999,7 @@ OneNote.Section#getRestApiId:member(1):
         // This is only required for SharePoint notebooks. baseUrl will be null for OneDrive notebooks.
         // For SharePoint notebooks, the notebook baseUrl should be used to talk to the 
         // OneNote REST API according to the OneNote Development Blog.
-        // https://docs.microsoft.com/archive/blogs/onenotedev/and-sharepoint-makes-three
+        // https://learn.microsoft.com/archive/blogs/onenotedev/and-sharepoint-makes-three
     });
 OneNote.Section#load:member(2):
   - |-

docs/code-snippets/outlook-snippets.yaml

@@ -725,7 +725,7 @@ Office.EmailAddressDetails#recipientType:member:
 Office.EmailUser:interface:
   - |-
     // The following example is an excerpt from a larger sample.
-    // For the full sample, visit https://docs.microsoft.com/office/dev/add-ins/outlook/extract-entity-strings-from-an-item.
+    // For the full sample, visit https://learn.microsoft.com/office/dev/add-ins/outlook/extract-entity-strings-from-an-item.
 
     // Gets instances of the task suggestion entity on the item.
     function myGetTaskSuggestions()

docs/code-snippets/word-snippets.yaml

@@ -160,7 +160,7 @@ Word.Body#insertInlinePictureFromBase64:member(1):
     });
 
     // Read "Create better add-ins for Word with Office Open XML" for guidance on working with OOXML.
-    // https://docs.microsoft.com/office/dev/add-ins/word/create-better-add-ins-for-word-with-office-open-xml
+    // https://learn.microsoft.com/office/dev/add-ins/word/create-better-add-ins-for-word-with-office-open-xml
 
     // The Word-Add-in-DocumentAssembly sample shows how you can use this API to assemble a document.
     // https://github.com/OfficeDev/Word-Add-in-DocumentAssembly
@@ -485,7 +485,7 @@ Word.ContentControl#insertOoxml:member(1):
     });  
 
     // Read "Create better add-ins for Word with Office Open XML" for guidance on working with OOXML.
-    // https://docs.microsoft.com/office/dev/add-ins/word/create-better-add-ins-for-word-with-office-open-xml
+    // https://learn.microsoft.com/office/dev/add-ins/word/create-better-add-ins-for-word-with-office-open-xml
 Word.ContentControl#insertParagraph:member(1):
   - |-
     // Run a batch operation against the Word object model.
@@ -1450,7 +1450,7 @@ Word.Range#insertOoxml:member(1):
     });
     
     // Read "Create better add-ins for Word with Office Open XML" for guidance on working with OOXML.
-    // https://docs.microsoft.com/office/dev/add-ins/word/create-better-add-ins-for-word-with-office-open-xml
+    // https://learn.microsoft.com/office/dev/add-ins/word/create-better-add-ins-for-word-with-office-open-xml
 Word.Range#insertParagraph:member(1):
   - |-
     // Run a batch operation against the Word object model.

docs/docs-ref-autogen/office/office/office.document.yml

@@ -314,7 +314,7 @@ methods:
       // for Project 2013 by using a text editor."
 
       //
-      https://docs.microsoft.com/office/dev/add-ins/project/create-your-first-task-pane-add-in-for-project-by-using-a-text-editor
+      https://learn.microsoft.com/office/dev/add-ins/project/create-your-first-task-pane-add-in-for-project-by-using-a-text-editor
 
       ```
 
@@ -427,7 +427,7 @@ methods:
       // using a text editor."
 
       //
-      https://docs.microsoft.com/office/dev/add-ins/project/create-your-first-task-pane-add-in-for-project-by-using-a-text-editor
+      https://learn.microsoft.com/office/dev/add-ins/project/create-your-first-task-pane-add-in-for-project-by-using-a-text-editor
 
       ```
 
@@ -523,7 +523,7 @@ methods:
       // see "Create your first task pane add-in for Project by using a text editor."
 
       //
-      https://docs.microsoft.com/office/dev/add-ins/project/create-your-first-task-pane-add-in-for-project-by-using-a-text-editor
+      https://learn.microsoft.com/office/dev/add-ins/project/create-your-first-task-pane-add-in-for-project-by-using-a-text-editor
 
       ```
     isPreview: false

docs/docs-ref-autogen/office_release/office/office.document.yml

@@ -314,7 +314,7 @@ methods:
       // for Project 2013 by using a text editor."
 
       //
-      https://docs.microsoft.com/office/dev/add-ins/project/create-your-first-task-pane-add-in-for-project-by-using-a-text-editor
+      https://learn.microsoft.com/office/dev/add-ins/project/create-your-first-task-pane-add-in-for-project-by-using-a-text-editor
 
       ```
 
@@ -427,7 +427,7 @@ methods:
       // using a text editor."
 
       //
-      https://docs.microsoft.com/office/dev/add-ins/project/create-your-first-task-pane-add-in-for-project-by-using-a-text-editor
+      https://learn.microsoft.com/office/dev/add-ins/project/create-your-first-task-pane-add-in-for-project-by-using-a-text-editor
 
       ```
 
@@ -523,7 +523,7 @@ methods:
       // see "Create your first task pane add-in for Project by using a text editor."
 
       //
-      https://docs.microsoft.com/office/dev/add-ins/project/create-your-first-task-pane-add-in-for-project-by-using-a-text-editor
+      https://learn.microsoft.com/office/dev/add-ins/project/create-your-first-task-pane-add-in-for-project-by-using-a-text-editor
 
       ```
     isPreview: false

docs/docs-ref-autogen/onenote/onenote/onenote.notebook.yml

@@ -206,7 +206,7 @@ methods:
           // This is only required for SharePoint notebooks. baseUrl will be null for OneDrive notebooks.
           // For SharePoint notebooks, the notebook baseUrl should be used to talk to the OneNote REST API
           // according to the OneNote Development Blog.
-          // https://docs.microsoft.com/archive/blogs/onenotedev/and-sharepoint-makes-three
+          // https://learn.microsoft.com/archive/blogs/onenotedev/and-sharepoint-makes-three
       });
       ```
     isPreview: false
@@ -273,7 +273,7 @@ methods:
               console.log("Base url: " + notebook.baseUrl);
               // This is only required for SharePoint notebooks, and will be null for OneDrive notebooks.
               // This baseUrl should be used to talk to OneNote REST APIs according to the OneNote Development Blog.
-              // https://docs.microsoft.com/archive/blogs/onenotedev/and-sharepoint-makes-three
+              // https://learn.microsoft.com/archive/blogs/onenotedev/and-sharepoint-makes-three
           });
           ```
   - name: load(propertyNamesAndPaths)

docs/docs-ref-autogen/onenote/onenote/onenote.page.yml

@@ -309,7 +309,7 @@ methods:
           // This is only required for SharePoint notebooks. baseUrl will be null for OneDrive notebooks.
           // For SharePoint notebooks, the notebook baseUrl should be used to talk to the OneNote REST API
           // according to the OneNote Development Blog.
-          // https://docs.microsoft.com/archive/blogs/onenotedev/and-sharepoint-makes-three
+          // https://learn.microsoft.com/archive/blogs/onenotedev/and-sharepoint-makes-three
       });
       ```
     isPreview: false

docs/docs-ref-autogen/onenote/onenote/onenote.section.yml

@@ -294,7 +294,7 @@ methods:
           // This is only required for SharePoint notebooks. baseUrl will be null for OneDrive notebooks.
           // For SharePoint notebooks, the notebook baseUrl should be used to talk to the 
           // OneNote REST API according to the OneNote Development Blog.
-          // https://docs.microsoft.com/archive/blogs/onenotedev/and-sharepoint-makes-three
+          // https://learn.microsoft.com/archive/blogs/onenotedev/and-sharepoint-makes-three
       });
       ```
     isPreview: false

docs/docs-ref-autogen/outlook/outlook/office.emailuser.yml

@@ -30,7 +30,7 @@ remarks: >-
   // The following example is an excerpt from a larger sample.
 
   // For the full sample, visit
-  https://docs.microsoft.com/office/dev/add-ins/outlook/extract-entity-strings-from-an-item.
+  https://learn.microsoft.com/office/dev/add-ins/outlook/extract-entity-strings-from-an-item.
 
 
   // Gets instances of the task suggestion entity on the item.

docs/docs-ref-autogen/outlook_1_1/outlook/office.emailuser.yml

@@ -30,7 +30,7 @@ remarks: >-
   // The following example is an excerpt from a larger sample.
 
   // For the full sample, visit
-  https://docs.microsoft.com/office/dev/add-ins/outlook/extract-entity-strings-from-an-item.
+  https://learn.microsoft.com/office/dev/add-ins/outlook/extract-entity-strings-from-an-item.
 
 
   // Gets instances of the task suggestion entity on the item.

docs/docs-ref-autogen/outlook_1_10/outlook/office.emailuser.yml

@@ -30,7 +30,7 @@ remarks: >-
   // The following example is an excerpt from a larger sample.
 
   // For the full sample, visit
-  https://docs.microsoft.com/office/dev/add-ins/outlook/extract-entity-strings-from-an-item.
+  https://learn.microsoft.com/office/dev/add-ins/outlook/extract-entity-strings-from-an-item.
 
 
   // Gets instances of the task suggestion entity on the item.

docs/docs-ref-autogen/outlook_1_11/outlook/office.emailuser.yml

@@ -30,7 +30,7 @@ remarks: >-
   // The following example is an excerpt from a larger sample.
 
   // For the full sample, visit
-  https://docs.microsoft.com/office/dev/add-ins/outlook/extract-entity-strings-from-an-item.
+  https://learn.microsoft.com/office/dev/add-ins/outlook/extract-entity-strings-from-an-item.
 
 
   // Gets instances of the task suggestion entity on the item.

docs/docs-ref-autogen/outlook_1_12/outlook/office.emailuser.yml

@@ -30,7 +30,7 @@ remarks: >-
   // The following example is an excerpt from a larger sample.
 
   // For the full sample, visit
-  https://docs.microsoft.com/office/dev/add-ins/outlook/extract-entity-strings-from-an-item.
+  https://learn.microsoft.com/office/dev/add-ins/outlook/extract-entity-strings-from-an-item.
 
 
   // Gets instances of the task suggestion entity on the item.

docs/docs-ref-autogen/outlook_1_2/outlook/office.emailuser.yml

@@ -30,7 +30,7 @@ remarks: >-
   // The following example is an excerpt from a larger sample.
 
   // For the full sample, visit
-  https://docs.microsoft.com/office/dev/add-ins/outlook/extract-entity-strings-from-an-item.
+  https://learn.microsoft.com/office/dev/add-ins/outlook/extract-entity-strings-from-an-item.
 
 
   // Gets instances of the task suggestion entity on the item.

docs/docs-ref-autogen/outlook_1_3/outlook/office.emailuser.yml

@@ -30,7 +30,7 @@ remarks: >-
   // The following example is an excerpt from a larger sample.
 
   // For the full sample, visit
-  https://docs.microsoft.com/office/dev/add-ins/outlook/extract-entity-strings-from-an-item.
+  https://learn.microsoft.com/office/dev/add-ins/outlook/extract-entity-strings-from-an-item.
 
 
   // Gets instances of the task suggestion entity on the item.

docs/docs-ref-autogen/outlook_1_4/outlook/office.emailuser.yml

@@ -30,7 +30,7 @@ remarks: >-
   // The following example is an excerpt from a larger sample.
 
   // For the full sample, visit
-  https://docs.microsoft.com/office/dev/add-ins/outlook/extract-entity-strings-from-an-item.
+  https://learn.microsoft.com/office/dev/add-ins/outlook/extract-entity-strings-from-an-item.
 
 
   // Gets instances of the task suggestion entity on the item.