Merge pull request #598 from OfficeDev/main

ElizabethSamuel-MSFT · web-flow · commit dfb2df0c0618 · 2023-03-30T15:20:11.000-07:00
[Admin] Publish
diff --git a/docs/develop/best-practices.md b/docs/develop/best-practices.md
@@ -1,15 +1,16 @@
 ---
 title: Best practices in Office Scripts
 description: How to prevent common problems and write robust Office Scripts to handle unexpected input or data.
-ms.date: 10/01/2022
+ms.topic: best-practice
+ms.date: 03/27/2023
 ms.localizationpriority: medium
 ---
 
 # Best practices in Office Scripts
 
 These patterns and practices are designed to help your scripts run successfully every time. Use them to avoid common pitfalls as you start automating your Excel workflow.
 
-## Use the Action Recorder to learn new features (web-only)
+## Use the Action Recorder to learn new features
 
 Excel does a lot of things. Most of them can be scripted. The Action Recorder records your Excel actions and translates them into code. This is the easiest way to learn about how different features work with Office Scripts. If you need code for a specific action, switch to the Action Recorder, perform the actions, select **Copy as code**, and paste the resulting code into your script.
 
diff --git a/docs/develop/external-calls.md b/docs/develop/external-calls.md
@@ -84,7 +84,7 @@ Any external API call fails when a script is run with Power Automate. This is a
 You'll have to use [HTTP with Azure AD](/connectors/webcontents/) or other equivalent actions to pull data from or push it to an external service.
 
 > [!WARNING]
-> External calls made through the Power Automate [Excel Online connector](/connectors/excelonlinebusiness) fail in order to help uphold existing data loss prevention policies. However, scripts that are run through Power Automate are done so outside of your organization, and outside of your organization's firewalls. For additional protection from malicious users in this external environment, your admin can control the use of Office Scripts. Your admin can either disable the Excel Online connector in Power Automate or turn off Office Scripts for Excel on the web through the [Office Scripts administrator controls](/microsoft-365/admin/manage/manage-office-scripts-settings).
+> External calls made through the Power Automate [Excel Online connector](/connectors/excelonlinebusiness) fail in order to help uphold existing data loss prevention policies. However, scripts that are run through Power Automate are done so outside of your organization, and outside of your organization's firewalls. For additional protection from malicious users in this external environment, your admin can control the use of Office Scripts. Your admin can either disable the Excel Online connector in Power Automate or turn off Office Scripts for Excel through the [Office Scripts administrator controls](/microsoft-365/admin/manage/manage-office-scripts-settings).
 
 ## See also
 
diff --git a/docs/develop/power-automate-integration.md b/docs/develop/power-automate-integration.md
@@ -1,6 +1,7 @@
 ---
 title: Run Office Scripts with Power Automate
 description: How to get Office Scripts for Excel working with a Power Automate workflow.
+ms.topic: integration
 ms.date: 12/19/2022
 ms.localizationpriority: medium
 ---
diff --git a/docs/develop/scripting-fundamentals.md b/docs/develop/scripting-fundamentals.md
@@ -1,6 +1,7 @@
 ---
 title: Fundamentals for Office Scripts in Excel
 description: Object model information and other basics to learn before writing Office Scripts.
+ms.topic: get-started
 ms.date: 10/01/2022
 ms.localizationpriority: high
 ---
diff --git a/docs/develop/vscode-for-scripts.md b/docs/develop/vscode-for-scripts.md
@@ -1,6 +1,7 @@
 ---
 title: Visual Studio Code for Office Scripts (preview)
 description: How to setup the Office Scripts Code Editor to connect with VS Code for the Web.
+ms.topic: integration
 ms.date: 11/04/2022
 ms.localizationpriority: medium
 ---
diff --git a/docs/docfx.json b/docs/docfx.json
@@ -59,6 +59,8 @@
         "testing/*.md": "excel"
       },
       "ms.topic": {
+        "resources/samples/*.md": "sample",
+        "resources/scenarios/*.md": "sample",
         "tutorials/*.md": "tutorial"
       },
       "ms.custom": {
diff --git a/docs/includes/platform-requirements.md b/docs/includes/platform-requirements.md
@@ -1,7 +1,6 @@
 To use Office Scripts, you'll need the following.
 
 1. Excel for Windows (version 2210 or higher), Excel for Mac, or Excel on the web.
-    1. The [Action Recorder](../overview/excel.md#action-recorder-web-only) is only available in Excel on the web.
 1. OneDrive for Business.
 1. Any commercial or educational Microsoft 365 license with access to the Microsoft 365 Office desktop apps, such as:
     - Office 365 Business
diff --git a/docs/includes/platform-support-table.md b/docs/includes/platform-support-table.md
@@ -1,7 +1,7 @@
 | | Excel on the web | Excel for Windows | Excel for Mac | Excel for iOS | Other Office products | Power Automate |
 |-|-|-|-|-|-|-|
 | **Office Scripts** | Yes | Yes | Yes | No | No | Yes |
-| **Office Scripts Action Recorder** | Yes | No | No | No | No | No |
+| **Office Scripts Action Recorder** | Yes | Yes | Yes | No | No | No |
 | **VBA macros** | No | Yes | Yes | No | Yes | No |
 | **Office Add-ins** | Yes | Yes | Yes | Yes | Yes | No |
 | **COM Add-ins** | No | Yes | Yes | No | Yes | No |
diff --git a/docs/overview/excel.md b/docs/overview/excel.md
@@ -2,13 +2,13 @@
 title: Office Scripts in Excel
 description: A brief introduction to the Action Recorder and Code Editor for Office Scripts.
 ms.topic: overview
-ms.date: 03/10/2023
+ms.date: 03/27/2023
 ms.localizationpriority: high
 ---
 
 # Office Scripts in Excel
 
-Office Scripts in Excel let you automate your day-to-day tasks. You can create and edit scripts with the Code Editor. Run a series of Excel steps with a single button. Then, share that script with coworkers so everyone can improve their workflow. Inside Excel on the web, you have an additional tool: the Action Recorder. This turns your manual steps into Office Scripts without having to look at any code.
+Office Scripts in Excel let you automate your day-to-day tasks. Use the Action Recorder to turn manual steps into reusable scripts. Edit those scripts or create new ones with the Code Editor. Let others in the workbook run these scripts with a single button. Then, share them with coworkers so everyone can improve their workflow.
 
 This series of documents teaches you how to use these tools. You'll find a wealth of samples covering different Excel scenarios. Use the tutorials to introduce yourself to the Action Recorder and Code Editor. These provide step-by-step guidance on how to record your frequent Excel actions, edit those scripts, and create new scripts from scratch.
 
diff --git a/docs/resources/add-ins-differences.md b/docs/resources/add-ins-differences.md
@@ -1,6 +1,7 @@
 ---
 title: Differences between Office Scripts and Office Add-ins
 description: The behavior and API differences between Office Scripts and Office Add-ins.
+ms.topic: product-comparison
 ms.date: 02/13/2023
 ms.localizationpriority: medium
 ---
diff --git a/docs/resources/power-query-differences.md b/docs/resources/power-query-differences.md
@@ -1,6 +1,7 @@
 ---
 title: When to use Power Query or Office Scripts
 description: The scenarios that are best suited for both the Power Query and Office Scripts platforms.
+ms.topic: product-comparison
 ms.date: 10/01/2022
 ms.localizationpriority: medium
 ---
@@ -43,7 +44,7 @@ Power Query is used in the [SQL Server](https://powerquery.microsoft.com/flow/)
 
 ## Platform dependencies
 
-Office Scripts is currently available for Excel for Windows, for Mac, and on the web.. The full Power Query experience is currently [only available for Excel for Windows](/power-query/power-query-what-is-power-query#where-can-you-use-power-query). Both can be used through Power Automate, which lets the flow work with Excel workbooks stored in OneDrive.
+Office Scripts is currently available for Excel for Windows, for Mac, and on the web. The full Power Query experience is currently [only available for Excel for Windows](/power-query/power-query-what-is-power-query#where-can-you-use-power-query). Both can be used through Power Automate, which lets the flow work with Excel workbooks stored in OneDrive.
 
 ## See also
 
diff --git a/docs/resources/vba-differences.md b/docs/resources/vba-differences.md
@@ -1,6 +1,7 @@
 ---
 title: Differences between Office Scripts and VBA macros
 description: The behavior and API differences between Office Scripts and Excel VBA macros.
+ms.topic: product-comparison
 ms.date: 02/13/2023
 ms.localizationpriority: medium
 ---
diff --git a/docs/testing/platform-limits.md b/docs/testing/platform-limits.md
@@ -1,6 +1,7 @@
 ---
 title: Platform limits and requirements with Office Scripts
 description: Resource limits and browser support for Office Scripts when used with Excel.
+ms.topic: limits-and-quotas
 ms.date: 03/10/2023
 ms.localizationpriority: medium
 ---
diff --git a/docs/testing/power-automate-troubleshooting.md b/docs/testing/power-automate-troubleshooting.md
@@ -1,6 +1,7 @@
 ---
 title: Troubleshoot Office Scripts running in Power Automate
 description: Tips, platform information, and known issues with the integration between Office Scripts and Power Automate.
+ms.topic: troubleshooting-general
 ms.date: 03/27/2023
 ms.localizationpriority: medium
 ---
diff --git a/docs/testing/troubleshooting.md b/docs/testing/troubleshooting.md
@@ -1,6 +1,7 @@
 ---
 title: Troubleshoot Office Scripts
 description: Debugging tips and techniques for Office Scripts, as well as help resources.
+ms.topic: troubleshooting-general
 ms.date: 02/24/2023
 ms.localizationpriority: medium
 ---
diff --git a/docs/tutorials/excel-tutorial.md b/docs/tutorials/excel-tutorial.md
@@ -1,13 +1,13 @@
 ---
 title: Record, edit, and create Office Scripts in Excel
 description: A tutorial about the basics of Office Scripts, including recording scripts with the Action Recorder and writing data to a workbook.
-ms.date: 01/11/2023
+ms.date: 03/27/2023
 ms.localizationpriority: high
 ---
 
 # Record, edit, and create Office Scripts in Excel
 
-This tutorial teaches you the basics of recording, editing, and writing an Office Script for Excel on the web. You'll record a script that applies some formatting to a sales record worksheet. You'll then edit the recorded script to apply more formatting, create a table, and sort that table. This record-then-edit pattern is an important tool to see what your Excel actions look like as code.
+This tutorial teaches you the basics of recording, editing, and writing an Office Script for Excel. You'll record a script that applies some formatting to a sales record worksheet. You'll then edit the recorded script to apply more formatting, create a table, and sort that table. This record-then-edit pattern is an important tool to see what your Excel actions look like as code.
 
 ## Prerequisites
 
@@ -20,7 +20,7 @@ This tutorial teaches you the basics of recording, editing, and writing an Offic
 
 First, you'll need some data and a small starting script.
 
-1. Create a new workbook in [Excel on the web](https://www.office.com/launch/excel). The Action Recorder is currently only available in Excel on the web, so that's where you must start this tutorial.
+1. Create a new Excel workbook.
 2. Copy the following fruit sales data and paste it into the worksheet, starting at cell **A1**.
 
     |Fruit |2018 |2019 |
