Merge pull request #341 from mkaszewiak/updateOverviewFile

updated and sorted overview lists

Author: lindalu-MSFT

docs/presentation/overview.md

@@ -20,11 +20,12 @@ This section provides how-to topics for working with presentation documents usin
 
 ## In this section
 
-- [Structure of a PresentationML document](structure-of-a-presentationml-document.md)  
+- [Structure of a PresentationML document](structure-of-a-presentationml-document.md)    
 
-- [Add a comment to a slide in a presentation](how-to-add-a-comment-to-a-slide-in-a-presentation.md)
-  
-- [Add a video to a slide in a presentation](how-to-add-a-video-to-a-slide-in-a-presentation.md)
+
+- [Add an audio file to a slide in a presentation](how-to-add-an-audio-to-a-slide-in-a-presentation.md)
+
+- [Add a comment to a slide in a presentation](how-to-add-a-comment-to-a-slide-in-a-presentation.md)  
 
 - [Apply a theme to a presentation](how-to-apply-a-theme-to-a-presentation.md)  
 
@@ -42,7 +43,7 @@ This section provides how-to topics for working with presentation documents usin
 
 - [Get all the text in all slides in a presentation](how-to-get-all-the-text-in-all-slides-in-a-presentation.md)  
 
-- [Get the titles of all the slides in a presentation](how-to-get-the-titles-of-all-the-slides-in-a-presentation.md)  
+- [Get the titles of all the slides in a presentation](how-to-get-the-titles-of-all-the-slides-in-a-presentation.md)
 
 - [Insert a new slide into a presentation](how-to-insert-a-new-slide-into-a-presentation.md)  
 
@@ -52,7 +53,7 @@ This section provides how-to topics for working with presentation documents usin
 
 - [Open a presentation document for read-only access](how-to-open-a-presentation-document-for-read-only-access.md)  
 
-- [Retrieve the number of slides in a presentation document](how-to-retrieve-the-number-of-slides-in-a-presentation-document.md)  
+- [Retrieve the number of slides in a presentation document](how-to-retrieve-the-number-of-slides-in-a-presentation-document.md)
 
 - [Working with animation](working-with-animation.md)  
 

docs/spreadsheet/overview.md

@@ -23,22 +23,12 @@ This section provides how-to topics for working with spreadsheet documents using
 
 - [Structure of a SpreadsheetML document](structure-of-a-spreadsheetml-document.md)
 
-- [Working with the calculation chain](working-with-the-calculation-chain.md)
-
-- [Working with conditional formatting](working-with-conditional-formatting.md)
-
-- [Working with formulas](working-with-formulas.md)
-
-- [Working with PivotTables](working-with-pivottables.md)
-
-- [Working with the shared string table](working-with-the-shared-string-table.md)
-
-- [Working with sheets](working-with-sheets.md)
-
-- [Working with SpreadsheetML tables](working-with-tables.md)
+- [Add custom UI to a spreadsheet document](how-to-add-custom-ui-to-a-spreadsheet-document.md)
 
 - [Calculate the sum of a range of cells in a spreadsheet document](how-to-calculate-the-sum-of-a-range-of-cells-in-a-spreadsheet-document.md)
 
+- [Copy a Worksheet Using SAX (Simple API for XML)](how-to-copy-a-worksheet-with-sax.md) 
+
 - [Create a spreadsheet document by providing a file name](how-to-create-a-spreadsheet-document-by-providing-a-file-name.md)
 
 - [Delete text from a cell in a spreadsheet document](how-to-delete-text-from-a-cell-in-a-spreadsheet.md)
@@ -69,6 +59,21 @@ This section provides how-to topics for working with spreadsheet documents using
 
 - [Retrieve the values of cells in a spreadsheet document](how-to-retrieve-the-values-of-cells-in-a-spreadsheet.md)
 
+- [Retrieve a list of the worksheets in a spreadsheet document](how-to-retrieve-a-list-of-the-worksheets-in-a-spreadsheet.md)
+
+- [Working with the calculation chain](working-with-the-calculation-chain.md)
+
+- [Working with conditional formatting](working-with-conditional-formatting.md)
+
+- [Working with formulas](working-with-formulas.md)
+
+- [Working with PivotTables](working-with-pivottables.md)
+
+- [Working with the shared string table](working-with-the-shared-string-table.md)
+
+- [Working with sheets](working-with-sheets.md)
+
+- [Working with SpreadsheetML tables](working-with-tables.md)
 
 ## Related sections
 

docs/word/overview.md

@@ -21,6 +21,8 @@ This section provides how-to topics for working with word processing documents u
 
 ## In this section 
 
+- [Structure of a WordprocessingML document](structure-of-a-wordprocessingml-document.md) 
+
 - [Accept all revisions in a word processing document](how-to-accept-all-revisions-in-a-word-processing-document.md)  
 
 - [Add tables to word processing documents](how-to-add-tables-to-word-processing-documents.md)  
@@ -59,13 +61,15 @@ This section provides how-to topics for working with word processing documents u
 
 - [Remove the headers and footers from a word processing document](how-to-remove-the-headers-and-footers-from-a-word-processing-document.md)  
 
+- [How to: Replace Text in a Word Document Using SAX (Simple API for XML)](how-to-replace-text-in-a-word-document-with-sax.md)  
+
 - [Replace the header in a word processing document](how-to-replace-the-header-in-a-word-processing-document.md)  
 
-- [Replace the styles parts in a word processing document](how-to-replace-the-styles-parts-in-a-word-processing-document.md)  
+- [Replace the styles parts in a word processing document](how-to-replace-the-styles-parts-in-a-word-processing-document.md) 
 
-- [Retrieve comments from a word processing document](how-to-retrieve-comments-from-a-word-processing-document.md)  
+- [Retrieve application property values from a Word document by using the Open XML API](how-to-retrieve-application-property-values-from-a-word-processing-document.md) 
 
-- [Retrieve property values from a Word document by using the Open XML API](how-to-retrieve-application-property-values-from-a-word-processing-document.md)
+- [Retrieve comments from a word processing document](how-to-retrieve-comments-from-a-word-processing-document.md)  
 
 - [Set a custom property in a word processing document](how-to-set-a-custom-property-in-a-word-processing-document.md)  
 
@@ -78,8 +82,7 @@ This section provides how-to topics for working with word processing documents u
 - [Working with runs](working-with-runs.md)  
 
 - [Working with WordprocessingML tables](working-with-wordprocessingml-tables.md)  
-
-- [Structure of a WordprocessingML document](structure-of-a-wordprocessingml-document.md)  
+ 
 
 ## Related sections 
 

samples/README.md

@@ -10,13 +10,27 @@ To add a sample, run the the following:
 
 This will create an initial scaffold for a sample and add it to the solution file.
 
+## Steps to Complete Before Creating a Pull Request:
+1. **Test Both Code Samples**
+Verify the functionality of both the C# and Visual Basic samples. To accelerate the process, you can use Copilot to translate the C# sample into Visual Basic. When writing code samples, avoid using var; instead, explicitly declare variable types.
+
+2. **Validate Documentation with DocFX**
+Use the https://dotnet.github.io/docfx/ to ensure the generated documentation renders correctly and behaves as expected.
+
+3. **Update the Table of Contents**
+Add a new entry to the toc.yml file so the content appears in the Navigation Pane on the Microsoft Learn website.
+
+4. **Edit the Overview Page**
+Update the overview.md file with the new title and markdown file reference to ensure it appears in the overview section on Microsoft Learn. This file is located in one of the following directories: docs/presentation, docs/spreadsheet, or docs/word.
+
+
 ## Migrate old samples
 
 ```powershell
 ./migrate-sample.ps1 path-to-md-file
 ```
 
-This will do an inital extraction and clean up of the file, as well as add the code to the solution. Additional clean up will be necessary, but should be minimal.
+This will do an initial extraction and clean up of the file, as well as add the code to the solution. Additional clean up will be necessary, but should be minimal.
 
 General changes to move a sample: