[excel] (Tutorials) Convert tutorial titles to reflect scenarios instead of features (#677)

AlexJerabek · ElizabethSamuel-MSFT · web-flow · commit 4db3f951ada4 · 2023-11-15T08:59:22.000-08:00
* Convert tutorial titles to reflect scenarios instead of features

* Remove extra space

* Shorter title

* Apply suggestions from code review

Co-authored-by: Elizabeth Samuel &lt;elizs@microsoft.com&gt;

* Apply suggestions from code review

Co-authored-by: Elizabeth Samuel &lt;elizs@microsoft.com&gt;

---------

Co-authored-by: Elizabeth Samuel &lt;elizs@microsoft.com&gt;
diff --git a/docs/develop/best-practices.md b/docs/develop/best-practices.md
@@ -109,7 +109,7 @@ A [`throw`](https://developer.mozilla.org/docs/web/javascript/reference/statemen
 
 However, if your script is running as part of a Power Automate flow, you may want to stop the flow from continuing. A `throw` statement stops the script and tells the flow to stop as well.
 
-The following script shows how to use the `throw` statement in our table checking example.
+The following script shows how to use the `throw` statement in the table-checking example.
 
 ```TypeScript
 function main(workbook: ExcelScript.Workbook) {
diff --git a/docs/develop/pivottables.md b/docs/develop/pivottables.md
@@ -117,7 +117,7 @@ There are three ways to filter a PivotTable.
 
 ### FilterPivotHierarchies
 
-`FilterPivotHierarchies` add an additional hierarchy to filter every data row. Any row with an item that is filtered out is excluded from the PivotTable and its summaries. Since these filters are based on items, they only work on discrete values. If "Classification" is a filter hierarchy in our sample, users can select the values of "Organic" and "Conventional" for the filter. Similarly, if "Crates Sold Wholesale" is selected, the filter options would be the individual numbers, such as 120 and 150, instead of numerical ranges.
+`FilterPivotHierarchies` add an additional hierarchy to filter every data row. Any row with an item that is filtered out is excluded from the PivotTable and its summaries. Since these filters are based on items, they only work on discrete values. If "Classification" is a filter hierarchy in the sample, users can select the values of "Organic" and "Conventional" for the filter. Similarly, if "Crates Sold Wholesale" is selected, the filter options would be the individual numbers, such as 120 and 150, instead of numerical ranges.
 
 `FilterPivotHierarchies` are created with all values selected. This means that nothing is filtered until the user manually interacts with the filter control or a `PivotManualFilter` is set on the field belonging to the `FilterPivotHierarchy`.
 
diff --git a/docs/develop/power-automate-integration.md b/docs/develop/power-automate-integration.md
@@ -18,9 +18,9 @@ If you are new to Power Automate, we recommend visiting [Get started with Power
 
 There are three step-by-step tutorials for Power Automate and Office Scripts. These show how to combine the automate services and pass data between a workbook and a flow.
 
-- [Call scripts from a manual Power Automate flow](../tutorials/excel-power-automate-manual.md)
-- [Pass data to scripts in an automatically-run Power Automate flow](../tutorials/excel-power-automate-trigger.md)
-- [Return data from a script to an automatically-run Power Automate flow](../tutorials//excel-power-automate-returns.md)
+- [Tutorial: Update a spreadsheet from a Power Automate flow](../tutorials/excel-power-automate-manual.md)
+- [Tutorial: Automatically save content from emails in a workbook](../tutorials/excel-power-automate-trigger.md)
+- [Tutorial: Send weekly email reminders based on spreadsheet data](../tutorials//excel-power-automate-returns.md)
 
 ### Create a flow from Excel
 
@@ -68,7 +68,7 @@ Power Automate lets you pass pieces of data between flow actions. Scripts can be
 
 Learn the details of how to pass data to and from your scripts with the following documentation.
 
-- Learn by doing with the [Pass data to scripts in an automatically-run Power Automate flow](../tutorials/excel-power-automate-trigger.md) and [Return data from a script to an automatically-run Power Automate flow](../tutorials/excel-power-automate-returns.md) tutorials.
+- Learn by doing with [Tutorial: Automatically save content from emails in a workbook](../tutorials/excel-power-automate-trigger.md) and [Tutorial: Send weekly email reminders based on spreadsheet data](../tutorials/excel-power-automate-returns.md).
 - Try the [Automated task reminders](../resources/scenarios/task-reminders.md) sample scenario to see everything in action.
 - Read [Pass data to and from scripts in Power Automate](power-automate-parameters-returns.md) for more usage scenarios and the technical TypeScript details.
 
@@ -101,7 +101,7 @@ function main(
 
 ## See also
 
-- [Call scripts from a manual Power Automate flow](../tutorials/excel-power-automate-manual.md)
+- [Tutorial: Update a spreadsheet from a Power Automate flow](../tutorials/excel-power-automate-manual.md)
 - [Pass data to and from scripts in Power Automate](power-automate-parameters-returns.md)
 - [Troubleshooting information for Power Automate with Office Scripts](../testing/power-automate-troubleshooting.md)
 - [Get started with Power Automate](/power-automate/getting-started)
diff --git a/docs/develop/power-automate-parameters-returns.md b/docs/develop/power-automate-parameters-returns.md
@@ -38,7 +38,7 @@ Acceptable types for returning data are the same as for parameters. Details on t
 
 ## See also
 
-- [Call scripts from a manual Power Automate flow](../tutorials/excel-power-automate-manual.md)
+- [Tutorial: Update a spreadsheet from a Power Automate flow](../tutorials/excel-power-automate-manual.md)
 - [Get user input for scripts](user-input.md)
 - [Run Office Scripts with Power Automate](power-automate-integration.md)
 - [Troubleshooting information for Power Automate with Office Scripts](../testing/power-automate-troubleshooting.md)
diff --git a/docs/develop/scripting-fundamentals.md b/docs/develop/scripting-fundamentals.md
@@ -10,7 +10,7 @@ ms.localizationpriority: high
 
 This article will introduce you to the technical aspects of Office Scripts. You'll learn the critical parts of the TypeScript-based script code and how the Excel objects and APIs work together.
 
-If you would prefer to get started with an interactive experience, try the tutorial [Record, edit, and create Office Scripts in Excel](../tutorials/excel-tutorial.md) or visit our [samples](../resources/samples/samples-overview.md).
+If you would prefer to get started with an interactive experience, try [Tutorial: Create and format an Excel table](../tutorials/excel-tutorial.md) or visit our [samples](../resources/samples/samples-overview.md).
 
 ## TypeScript: The language of Office Scripts
 
@@ -323,8 +323,8 @@ For information specific to the PivotTable object model, see [Work with PivotTab
 
 ## See also
 
-- [Record, edit, and create Office Scripts in Excel](../tutorials/excel-tutorial.md)
-- [Read workbook data with Office Scripts in Excel](../tutorials/excel-read-tutorial.md)
+- [Tutorial: Create and format an Excel table](../tutorials/excel-tutorial.md)
+- [Tutorial: Clean and normalize Excel workbook data](../tutorials/excel-read-tutorial.md)
 - [Office Scripts API reference](/javascript/api/office-scripts/overview)
 - [Work with PivotTables in Office Scripts](pivottables.md)
 - [Using built-in JavaScript objects in Office Scripts](javascript-objects.md)
diff --git a/docs/index.md b/docs/index.md
@@ -40,7 +40,7 @@ Use Office Scripts in Excel to automate your common tasks. Explore the following
                     </div>
                     <div class="cardText">
                         <h3>Getting started</h3>
-                        <p><a href="tutorials/excel-tutorial.md">Complete the tutorial to learn how to record, edit, and create Office Scripts in Excel.</a></p>
+                        <p><a href="tutorials/excel-tutorial.md">Create and format a table with Office Scripts.</a></p>
                     </div>
                 </div>
             </div>
diff --git a/docs/resources/samples/count-blank-rows.md b/docs/resources/samples/count-blank-rows.md
@@ -13,7 +13,7 @@ This project includes two scripts:
 * [Count blank rows on all sheets](#sample-code-count-blank-rows-on-all-sheets): Traverses the used range on _all of the worksheets_ and returns a blank row count.
 
 > [!NOTE]
-> For our script, a blank row is any row where there's no data. The row can have formatting.
+> For your script, a blank row is any row where there's no data. The row can have formatting.
 
 _This sheet returns count of 4 blank rows_
 
diff --git a/docs/resources/samples/range-samples.md b/docs/resources/samples/range-samples.md
@@ -317,4 +317,4 @@ We welcome suggestions for new samples. If there's a common scenario that would
 
 * [Sudhi Ramamurthy's "Range basics" on YouTube](https://youtu.be/4emjkOFdLBA)
 * [Office Scripts samples and scenarios](samples-overview.md)
-* [Record, edit, and create Office Scripts in Excel](../../tutorials/excel-tutorial.md)
+* [Tutorial: Create and format an Excel table](../../tutorials/excel-tutorial.md)
diff --git a/docs/resources/vba-differences.md b/docs/resources/vba-differences.md
@@ -42,7 +42,7 @@ Office Scripts don't support Excel-level [events](/office/vba/excel/concepts/eve
 
 VBA doesn't have a Power Automate connector. All supported VBA scenarios involve a user attending to the macro's execution.
 
-Office Scripts can be run through Power Automate. Your workbook can be updated through scheduled or event-driven flows, letting you automate workflows without even opening Excel. Try the [Call scripts from a manual Power Automate flow](../tutorials/excel-power-automate-manual.md) tutorial to start learning about Power Automate. You can also check out the [Automated task reminders](scenarios/task-reminders.md) sample to see Office Scripts connected to Teams through Power Automate in a real-world scenario.
+Office Scripts can be run through Power Automate. Your workbook can be updated through scheduled or event-driven flows, letting you automate workflows without even opening Excel. Try [Tutorial: Update a spreadsheet from a Power Automate flow](../tutorials/excel-power-automate-manual.md) to start learning about Power Automate. You can also check out the [Automated task reminders](scenarios/task-reminders.md) sample to see Office Scripts connected to Teams through Power Automate in a real-world scenario.
 
 ## See also
 
diff --git a/docs/toc.yml b/docs/toc.yml
@@ -8,15 +8,15 @@ items:
     href: overview/excel.md
   - name: Tutorials
     items:
-    - name: Learn the basics of Office Scripts
+    - name: Create and format an Excel table
       href: tutorials/excel-tutorial.md
-    - name: Read workbook data with a script
+    - name: Clean and normalize Excel workbook data
       href: tutorials/excel-read-tutorial.md
-    - name: Call scripts from a manual Power Automate flow
+    - name: Update a spreadsheet from a Power Automate flow
       href: tutorials/excel-power-automate-manual.md
-    - name: Use data in a script from an automatically-run Power Automate flow
+    - name: Automatically save content from emails in a workbook
       href: tutorials/excel-power-automate-trigger.md
-    - name: Pass data from a script to Power Automate flow
+    - name: Send weekly email reminders based on spreadsheet data
       href: tutorials/excel-power-automate-returns.md
   - name: Script fundamentals
     href: develop/scripting-fundamentals.md
@@ -70,6 +70,8 @@ items:
         href: resources/samples/range-samples.md
       - name: Tables
         href: resources/samples/table-samples.md
+      - name: Dates
+        href: resources/samples/javascript-dates.md
       - name: Add comments
         href: resources/samples/add-excel-comments.md
       - name: Add images to a workbook
@@ -80,8 +82,6 @@ items:
         href: resources/samples/data-validation-samples.md
       - name: Create a workbook table of contents
         href: resources/samples/table-of-contents.md
-      - name: JavaScript Dates
-        href: resources/samples/javascript-dates.md
       - name: Remove table column filters
         href: resources/samples/clear-table-filter-for-active-cell.md
       - name: Report day-to-day changes in Power Automate
diff --git a/docs/tutorials/excel-power-automate-manual.md b/docs/tutorials/excel-power-automate-manual.md
@@ -1,16 +1,16 @@
 ---
-title: Call scripts from a manual Power Automate flow
+title: 'Tutorial: Update a spreadsheet from a Power Automate flow'
 description: A tutorial about how to use an Office Script in Power Automate through a manual trigger.
-ms.date: 11/10/2023
+ms.date: 11/14/2023
 ms.localizationpriority: high
 ---
 
-# Call scripts from a manual Power Automate flow
+# Tutorial: Update a spreadsheet from a Power Automate flow
 
 This tutorial teaches you how to run an Office Script for Excel through [Power Automate](https://make.powerautomate.com). You'll make a script that updates the values of two cells with the current time. You'll then connect that script to a manually triggered Power Automate flow, so that the script is run whenever a button in Power Automate is selected. Once you understand the basic pattern, you can expand the flow to include other applications and automate more of your daily workflow.
 
 > [!TIP]
-> If you are new to Office Scripts, we recommend starting with the [Record, edit, and create Office Scripts in Excel](excel-tutorial.md) tutorial. [Office Scripts use TypeScript](../overview/code-editor-environment.md) and this tutorial is intended for people with beginner to intermediate-level knowledge of JavaScript or TypeScript. If you're new to JavaScript, we recommend starting with the [Mozilla JavaScript tutorial](https://developer.mozilla.org/docs/Web/JavaScript/Guide/Introduction).
+> If you are new to Office Scripts, we recommend starting with [Tutorial: Create and format an Excel table](excel-tutorial.md). [Office Scripts use TypeScript](../overview/code-editor-environment.md) and this tutorial is intended for people with beginner to intermediate-level knowledge of JavaScript or TypeScript. If you're new to JavaScript, we recommend starting with the [Mozilla JavaScript tutorial](https://developer.mozilla.org/docs/Web/JavaScript/Guide/Introduction).
 
 ## Prerequisites
 
@@ -125,4 +125,4 @@ Your flow is now ready to be run through Power Automate. You can test it using t
 
 ## Next steps
 
-Complete the [Pass data to scripts in an automatically-run Power Automate flow](excel-power-automate-trigger.md) tutorial. It teaches you how to pass data from a workflow service to your Office Script and run the Power Automate flow when certain events occur.
+Complete [Tutorial: Automatically save content from emails in a workbook](excel-power-automate-trigger.md). It teaches you how to pass data from a workflow service to your Office Script and run the Power Automate flow when certain events occur.
diff --git a/docs/tutorials/excel-power-automate-returns.md b/docs/tutorials/excel-power-automate-returns.md
@@ -1,18 +1,18 @@
 ---
-title: Return data from a script to an automatically-run Power Automate flow
+title: 'Tutorial: Send weekly email reminders based on spreadsheet data'
 description: A tutorial that shows how to send reminder emails by running Office Scripts for Excel through Power Automate.
-ms.date: 10/01/2022
+ms.date: 11/14/2023
 ms.localizationpriority: high
 ---
 
-# Return data from a script to an automatically-run Power Automate flow
+# Tutorial: Send weekly email reminders based on spreadsheet data
 
 This tutorial teaches you how to return information from an Office Script for Excel as part of an automated [Power Automate](https://make.powerautomate.com) workflow. You'll make a script that looks through a schedule and works with a flow to send reminder emails. This flow will run on a regular schedule, providing these reminders on your behalf.
 
 > [!TIP]
-> If you're new to Office Scripts, we recommend starting with the [Record, edit, and create Office Scripts in Excel](excel-tutorial.md) tutorial.
+> If you're new to Office Scripts, we recommend starting with [Tutorial: Create and format an Excel table](excel-tutorial.md).
 >
-> If you're new to Power Automate, we recommend starting with the [Call scripts from a manual Power Automate flow](excel-power-automate-manual.md) and [Pass data to scripts in an automatically-run Power Automate flow](excel-power-automate-trigger.md) tutorials.
+> If you're new to Power Automate, we recommend starting with [Tutorial: Update a spreadsheet from a Power Automate flow](excel-power-automate-manual.md) and [Tutorial: Automatically save content from emails in a workbook](excel-power-automate-trigger.md).
 >
 > [Office Scripts use TypeScript](../overview/code-editor-environment.md) and this tutorial is intended for people with beginner to intermediate-level knowledge of JavaScript or TypeScript. If you're new to JavaScript, we recommend starting with the [Mozilla JavaScript tutorial](https://developer.mozilla.org/docs/Web/JavaScript/Guide/Introduction).
 
@@ -41,14 +41,14 @@ This tutorial teaches you how to return information from an Office Script for Ex
 
 1. Name the script **Get On-Call Person**.
 
-1. You should now have an empty script. We want to use the script to get an email address from the spreadsheet. Change `main` to return a string, like this:
+1. You should now have an empty script. You want a script that gets an email address from the spreadsheet. Change `main` to return a string, like this:
 
     ```TypeScript
     function main(workbook: ExcelScript.Workbook) : string {
     }
     ```
 
-1. Next, you need to get all the data from the table. That lets us look through each row with the script. Add the following code inside the `main` function.
+1. Next, you need to get all the data from the table. That lets the script look at each row. Add the following code inside the `main` function.
 
     ```TypeScript
     // Get the H1 worksheet.
@@ -61,7 +61,7 @@ This tutorial teaches you how to return information from an Office Script for Ex
     let tableValues = table.getRangeBetweenHeaderAndTotal().getValues();
     ```
 
-1. The dates in the table are stored using [Excel's date serial number](https://support.microsoft.com/office/e7fe7167-48a9-4b96-bb53-5612a800b487). We need to convert those dates to JavaScript dates in order to compare them. We'll add a helper function to our script. Add the following code outside of the `main` function.
+1. The dates in the table are stored using [Excel's date serial number](https://support.microsoft.com/office/e7fe7167-48a9-4b96-bb53-5612a800b487). You need to convert those dates to JavaScript dates in order to compare them. Add the following helper function outside of the `main` function.
 
     ```TypeScript
     // Convert the Excel date to a JavaScript Date object.
@@ -71,7 +71,7 @@ This tutorial teaches you how to return information from an Office Script for Ex
     }
     ```
 
-1. Now, you need to figure out which person is on call right now. Their row will have a start and end date surrounding the current date. We'll write the script to assume only one person is on call at a time. Scripts can return arrays to handle multiple values, but you can return the first matching email address for this tutorial. Add the following code to the end of the `main` function.
+1. Now, you need to figure out which person is on call right now. Their row will have a start and end date surrounding the current date. The script will assume only one person is on call at a time. Scripts can return arrays to handle multiple values, but you can return the first matching email address for this tutorial. Add the following code to the end of the `main` function.
 
     ```TypeScript
     // Look for the first row where today's date is between the row's start and end dates.
@@ -130,7 +130,7 @@ This tutorial teaches you how to return information from an Office Script for Ex
 
     :::image type="content" source="../images/power-automate-return-tutorial-2.png" alt-text="The Scheduled cloud flow button in Power Automate.":::
 
-1. Next, set the schedule for this flow. Our spreadsheet has a new on-call assignment starting every Monday in the first half of 2022. Let's set the flow to run first thing Monday mornings. Use the following options to configure the flow to run on Monday each week.
+1. Next, set the schedule for this flow. Your spreadsheet has a new on-call assignment starting every Monday in the first half of 2022. Set the flow to run first thing Monday mornings. Use the following options to configure the flow to run on Monday each week.
 
     - **Flow name**: Notify On-Call Person
     - **Starting**: 1/3/22 at 1:00am
@@ -162,7 +162,7 @@ This tutorial teaches you how to return information from an Office Script for Ex
 
 1. Select **New step**.
 
-1. We'll end the flow by sending the reminder email. Select **Send an email (V2)** by using the connector's search bar. Use the **Add dynamic content** control to add the email address returned by the script. This will be labelled **result** with the Excel icon next to it. You can provide whatever subject and body text you'd like.
+1. End the flow by sending the reminder email. Select **Send an email (V2)** by using the connector's search bar. Use the **Add dynamic content** control to add the email address returned by the script. This will be labelled **result** with the Excel icon next to it. You can provide whatever subject and body text you'd like.
 
     :::image type="content" source="../images/power-automate-return-tutorial-5.png" alt-text="The Power Automate Outlook connector settings for sending an email. The options include the file to send, the subject of the email, and the body of the email as well as advanced options.":::
 
diff --git a/docs/tutorials/excel-power-automate-trigger.md b/docs/tutorials/excel-power-automate-trigger.md
diff --git a/docs/tutorials/excel-read-tutorial.md b/docs/tutorials/excel-read-tutorial.md
diff --git a/docs/tutorials/excel-tutorial.md b/docs/tutorials/excel-tutorial.md
