diff --git a/docs/about-the-open-xml-sdk.md b/docs/about-the-open-xml-sdk.md
index b76a0ef8..199dd727 100644
--- a/docs/about-the-open-xml-sdk.md
+++ b/docs/about-the-open-xml-sdk.md
@@ -27,7 +27,7 @@ The document parts in an Open XML package are created as XML markup. Because XML
Structurally, an Open XML document is an Open Packaging Conventions (OPC) package. As stated previously, a package is composed of a collection of document parts. Each part has a part name that consists of a sequence of segments or a pathname such as "/word/theme/theme1.xml." The package contains a [Content\_Types].xml part that allows you to determine the content type of all document parts in the package. A set of explicit relationships for a source package or part is contained in a relationships part that ends with the .rels extension.
-Word processing documents are described by using WordprocessingML markup. For more information, see [Working with WordprocessingML documents (Open XML SDK)](working-with-wordprocessingml-documents.md). A WordprocessingML document is composed of a collection of stories where each story is one of the following:
+Word processing documents are described by using WordprocessingML markup. For more information, see [Working with WordprocessingML documents (Open XML SDK)](word/overview.md). A WordprocessingML document is composed of a collection of stories where each story is one of the following:
- Main document (the only required story)
- Glossary document
@@ -36,7 +36,7 @@ Word processing documents are described by using WordprocessingML markup. For mo
- Text box
- Footnote and endnote
-Presentations are described by using PresentationML markup. For more information, see [Working with PresentationML documents (Open XML SDK)](working-with-presentationml-documents.md). Presentation packages can contain the following document parts:
+Presentations are described by using PresentationML markup. For more information, see [Working with PresentationML documents (Open XML SDK)](presentation/overview.md). Presentation packages can contain the following document parts:
- Slide master
- Notes master
@@ -44,7 +44,7 @@ Presentations are described by using PresentationML markup. For more information
- Slide layout
- Notes
-Spreadsheet workbooks are described by using SpreadsheetML markup. For more information, see [Working with SpreadsheetML documents (Open XML SDK)](working-with-spreadsheetml-documents.md). Workbook packages can contain:
+Spreadsheet workbooks are described by using SpreadsheetML markup. For more information, see [Working with SpreadsheetML documents (Open XML SDK)](spreadsheet/overview.md). Workbook packages can contain:
- Workbook part (required part)
- One or more worksheets
@@ -52,16 +52,6 @@ Spreadsheet workbooks are described by using SpreadsheetML markup. For more info
- Tables
- Custom XML
-## Open XML SDK 1.0
-
-Version 1 of the Open XML SDK simplified the manipulation of Open XML packages. The Open XML SDK Application Programming Interface (API) encapsulates many of the common tasks that you typically perform on Open XML packages, so you can perform complex operations with just a few lines of code. Some common tasks:
-
-- **Search** With a few lines of code, you can search a collection of Excel 2007 worksheets for some arbitrary data.
-- **Document assembly** You can create documents by combining the document parts of existing documents programmatically. For example, you can pull slides from various PowerPoint 2007 presentations to create a single presentation.
-- **Validation** With a few lines of code, you can validate the document parts in a package or validate an entire package against a schema.
-- **Data update** With the Open XML object model, you can easily modify the data in multiple packages.
-- **Privacy** With a few lines of code, you can remove comments and other personal information from a document before it is distributed.
-
## Open XML SDK for Microsoft Office
The SDK supports the following common tasks/scenarios:
diff --git a/docs/how-to-add-a-new-document-part-that-receives-a-relationship-id-to-a-package.md b/docs/general/how-to-add-a-new-document-part-that-receives-a-relationship-id-to-a-package.md
similarity index 99%
rename from docs/how-to-add-a-new-document-part-that-receives-a-relationship-id-to-a-package.md
rename to docs/general/how-to-add-a-new-document-part-that-receives-a-relationship-id-to-a-package.md
index 43ae2353..ae23a12f 100644
--- a/docs/how-to-add-a-new-document-part-that-receives-a-relationship-id-to-a-package.md
+++ b/docs/general/how-to-add-a-new-document-part-that-receives-a-relationship-id-to-a-package.md
@@ -57,7 +57,7 @@ a word-processing document package.
-----------------------------------------------------------------------------
-[!include[Structure](./includes/word/structure.md)]
+[!include[Structure](../includes/word/structure.md)]
-----------------------------------------------------------------------------
## How the Sample Code Works
diff --git a/docs/how-to-add-a-new-document-part-to-a-package.md b/docs/general/how-to-add-a-new-document-part-to-a-package.md
similarity index 99%
rename from docs/how-to-add-a-new-document-part-to-a-package.md
rename to docs/general/how-to-add-a-new-document-part-to-a-package.md
index f2669dd5..5aea6e69 100644
--- a/docs/how-to-add-a-new-document-part-to-a-package.md
+++ b/docs/general/how-to-add-a-new-document-part-to-a-package.md
@@ -53,7 +53,7 @@ The code starts with opening a package file by passing a file name to one of the
The **using** statement provides a recommended alternative to the typical .Create, .Save, .Close sequence. It ensures that the **Dispose** method (internal method used by the Open XML SDK to clean up resources) is automatically called when the closing brace is reached. The block that follows the **using** statement establishes a scope for the object that is created or named in the **using** statement, in this case **wordDoc**. Because the **WordprocessingDocument** class in the Open XML SDK
automatically saves and closes the object as part of its **System.IDisposable** implementation, and because the **Dispose** method is automatically called when you exit the block; you do not have to explicitly call **Save** and **Close**, as long as you use **using**.
-[!include[Structure](./includes/word/structure.md)]
+[!include[Structure](../includes/word/structure.md)]
## How the sample code works
diff --git a/docs/how-to-copy-the-contents-of-an-open-xml-package-part-to-a-document-part-in-a-dif.md b/docs/general/how-to-copy-the-contents-of-an-open-xml-package-part-to-a-document-part-in-a-dif.md
similarity index 99%
rename from docs/how-to-copy-the-contents-of-an-open-xml-package-part-to-a-document-part-in-a-dif.md
rename to docs/general/how-to-copy-the-contents-of-an-open-xml-package-part-to-a-document-part-in-a-dif.md
index 98f84682..fcff6a1f 100644
--- a/docs/how-to-copy-the-contents-of-an-open-xml-package-part-to-a-document-part-in-a-dif.md
+++ b/docs/general/how-to-copy-the-contents-of-an-open-xml-package-part-to-a-document-part-in-a-dif.md
@@ -91,7 +91,7 @@ long as you use **using**.
--------------------------------------------------------------------------------
-[!include[Structure](./includes/word/structure.md)]
+[!include[Structure](../includes/word/structure.md)]
--------------------------------------------------------------------------------
## The Theme Part
diff --git a/docs/how-to-create-a-package.md b/docs/general/how-to-create-a-package.md
similarity index 99%
rename from docs/how-to-create-a-package.md
rename to docs/general/how-to-create-a-package.md
index 247218e2..9283e463 100644
--- a/docs/how-to-create-a-package.md
+++ b/docs/general/how-to-create-a-package.md
@@ -103,7 +103,7 @@ Once you have created the Word document package, you can add parts to
it. To add the main document part you call the [AddMainDocumentPart()](https://msdn.microsoft.com/library/office/documentformat.openxml.packaging.wordprocessingdocument.addmaindocumentpart.aspx) method of the **WordprocessingDocument** class. Having done that,
you can set about adding the document structure and text.
-[!include[Structure](./includes/word/structure.md)]
+[!include[Structure](../includes/word/structure.md)]
## How the Sample Code Works
diff --git a/docs/how-to-get-the-contents-of-a-document-part-from-a-package.md b/docs/general/how-to-get-the-contents-of-a-document-part-from-a-package.md
similarity index 99%
rename from docs/how-to-get-the-contents-of-a-document-part-from-a-package.md
rename to docs/general/how-to-get-the-contents-of-a-document-part-from-a-package.md
index a02fee0f..a898ed6b 100644
--- a/docs/how-to-get-the-contents-of-a-document-part-from-a-package.md
+++ b/docs/general/how-to-get-the-contents-of-a-document-part-from-a-package.md
@@ -89,7 +89,7 @@ long as you use using.
---------------------------------------------------------------------------------
-[!include[Structure](./includes/word/structure.md)]
+[!include[Structure](../includes/word/structure.md)]
--------------------------------------------------------------------------------
## Comments Element
diff --git a/docs/how-to-remove-a-document-part-from-a-package.md b/docs/general/how-to-remove-a-document-part-from-a-package.md
similarity index 99%
rename from docs/how-to-remove-a-document-part-from-a-package.md
rename to docs/general/how-to-remove-a-document-part-from-a-package.md
index fb65c3af..8d17b092 100644
--- a/docs/how-to-remove-a-document-part-from-a-package.md
+++ b/docs/general/how-to-remove-a-document-part-from-a-package.md
@@ -86,7 +86,7 @@ long as you use **using**.
---------------------------------------------------------------------------------
-[!include[Structure](./includes/word/structure.md)]
+[!include[Structure](../includes/word/structure.md)]
--------------------------------------------------------------------------------
## Settings Element
diff --git a/docs/how-to-replace-the-theme-part-in-a-word-processing-document.md b/docs/general/how-to-replace-the-theme-part-in-a-word-processing-document.md
similarity index 98%
rename from docs/how-to-replace-the-theme-part-in-a-word-processing-document.md
rename to docs/general/how-to-replace-the-theme-part-in-a-word-processing-document.md
index 0e8d22a2..1102cb2a 100644
--- a/docs/how-to-replace-the-theme-part-in-a-word-processing-document.md
+++ b/docs/general/how-to-replace-the-theme-part-in-a-word-processing-document.md
@@ -102,7 +102,7 @@ themes in use applied to a presentation. In this example, you can see
how a theme can affect font, colors, backgrounds, fills, and effects for
different objects in a presentation. end example]
-
+
In this example, we see how a theme can affect font, colors,
backgrounds, fills, and effects for different objects in a presentation.
*end example*]
@@ -226,10 +226,10 @@ font.
Following is the complete sample code in both C\# and Visual Basic.
### [C#](#tab/cs)
-[!code-csharp[](../samples/word/replace_the_theme_part/cs/Program.cs)]
+[!code-csharp[](../../samples/word/replace_the_theme_part/cs/Program.cs)]
### [Visual Basic](#tab/vb)
-[!code-vb[](../samples/word/replace_the_theme_part/vb/Program.vb)]
+[!code-vb[](../../samples/word/replace_the_theme_part/vb/Program.vb)]
## See also
diff --git a/docs/how-to-search-and-replace-text-in-a-document-part.md b/docs/general/how-to-search-and-replace-text-in-a-document-part.md
similarity index 96%
rename from docs/how-to-search-and-replace-text-in-a-document-part.md
rename to docs/general/how-to-search-and-replace-text-in-a-document-part.md
index e239f6aa..240323c9 100644
--- a/docs/how-to-search-and-replace-text-in-a-document-part.md
+++ b/docs/general/how-to-search-and-replace-text-in-a-document-part.md
@@ -103,10 +103,10 @@ the text, "Hello world!"
The following is the complete sample code in both C\# and Visual Basic.
### [C#](#tab/cs)
-[!code-csharp[](../samples/word/search_and_replace_text_a_part/cs/Program.cs)]
+[!code-csharp[](../../samples/word/search_and_replace_text_a_part/cs/Program.cs)]
### [Visual Basic](#tab/vb)
-[!code-vb[](../samples/word/search_and_replace_text_a_part/vb/Program.vb)]
+[!code-vb[](../../samples/word/search_and_replace_text_a_part/vb/Program.vb)]
--------------------------------------------------------------------------------
## See also
diff --git a/docs/introduction-to-markup-compatibility.md b/docs/general/introduction-to-markup-compatibility.md
similarity index 100%
rename from docs/introduction-to-markup-compatibility.md
rename to docs/general/introduction-to-markup-compatibility.md
diff --git a/docs/packages-and-general.md b/docs/general/overview.md
similarity index 89%
rename from docs/packages-and-general.md
rename to docs/general/overview.md
index a83cfe0b..9335be8b 100644
--- a/docs/packages-and-general.md
+++ b/docs/general/overview.md
@@ -21,6 +21,8 @@ This section provides how-to topics for working with documents and packages usin
## In this section
+- [Introduction to markup compatibility](introduction-to-markup-compatibility.md)
+
- [Add a new document part that receives a relationship ID to a package](how-to-add-a-new-document-part-that-receives-a-relationship-id-to-a-package.md)
- [Add a new document part to a package](how-to-add-a-new-document-part-to-a-package.md)
@@ -40,5 +42,4 @@ This section provides how-to topics for working with documents and packages usin
## Related sections
-- [How do I...](how-do-i.md)
-- [Getting started with the Open XML SDK for Office](getting-started.md)
+- [Getting started with the Open XML SDK for Office](../getting-started.md)
diff --git a/docs/how-do-i.md b/docs/how-do-i.md
deleted file mode 100644
index 6eefcc0f..00000000
--- a/docs/how-do-i.md
+++ /dev/null
@@ -1,31 +0,0 @@
----
-
-api_name:
-- Microsoft.Office.DocumentFormat.OpenXML.Packaging
-api_type:
-- schema
-ms.assetid: b5cc0e8d-da79-482a-81fa-f18c18d29f6c
-title: How do I... (Open XML SDK)
-ms.suite: office
-
-ms.author: o365devx
-author: o365devx
-ms.topic: conceptual
-ms.date: 11/01/2017
-ms.localizationpriority: high
----
-# How do I... (Open XML SDK)
-
-This section provides how-to topics for working with the Open XML SDK for Office.
-
-[!include[Add-ins note](./includes/addinsnote.md)]
-
-## In this section
-
-[Presentations (Open XML SDK)](presentations.md)
-
-[Packages and general (Open XML SDK)](packages-and-general.md)
-
-[Spreadsheets (Open XML SDK)](spreadsheets.md)
-
-[Word processing (Open XML SDK)](word-processing.md)
diff --git a/docs/includes/word/structure.md b/docs/includes/word/structure.md
index 3c4975d7..6ec35465 100644
--- a/docs/includes/word/structure.md
+++ b/docs/includes/word/structure.md
@@ -24,4 +24,4 @@ Using the Open XML SDK, you can create document structure and content using stro
| r | [Run](https://msdn.microsoft.com/library/office/documentformat.openxml.wordprocessing.run.aspx) | A run. |
| t | [Text](https://msdn.microsoft.com/library/office/documentformat.openxml.wordprocessing.text.aspx) | A range of text. |
-For more information about the overall structure of the parts and elements of a WordprocessingML document, see [Structure of a WordprocessingML document (Open XML SDK)](../../structure-of-a-wordprocessingml-document.md).
\ No newline at end of file
+For more information about the overall structure of the parts and elements of a WordprocessingML document, see [Structure of a WordprocessingML document (Open XML SDK)](../../word/structure-of-a-wordprocessingml-document.md).
\ No newline at end of file
diff --git a/docs/open-xml-sdk.md b/docs/open-xml-sdk.md
index b9141bf0..332bfb62 100644
--- a/docs/open-xml-sdk.md
+++ b/docs/open-xml-sdk.md
@@ -46,11 +46,19 @@ Portions of ISO/IEC 29500:20081 are referenced in the SDK.
## In this section
-- [Getting started with the Open XML SDK for Office](getting-started.md)
-- [Understanding the Open XML file formats](understanding-the-open-xml-file-formats.md)
-- [How do I... (Open XML SDK)](how-do-i.md)
+- [Getting started with the Open XML SDK for Office](getting-started.md)
- [Open XML SDK class library reference](/office/open-xml/open-xml-sdk)
+## Working with packages
+
+- [Packages](general/overview.md)
+
+- [Presentations](presentation/overview.md)
+
+- [Spreadsheets](spreadsheet/overview.md)
+
+- [Word processing](word/overview.md)
+
## See also
- [Open XML SDK for Microsoft Office](https://www.nuget.org/packages/DocumentFormat.OpenXml)
diff --git a/docs/how-to-add-a-comment-to-a-slide-in-a-presentation.md b/docs/presentation/how-to-add-a-comment-to-a-slide-in-a-presentation.md
similarity index 95%
rename from docs/how-to-add-a-comment-to-a-slide-in-a-presentation.md
rename to docs/presentation/how-to-add-a-comment-to-a-slide-in-a-presentation.md
index 84b6f8ad..b85efb14 100644
--- a/docs/how-to-add-a-comment-to-a-slide-in-a-presentation.md
+++ b/docs/presentation/how-to-add-a-comment-to-a-slide-in-a-presentation.md
@@ -22,7 +22,7 @@ Office to add a comment to the first slide in a presentation
programmatically.
-[!include[Structure](./includes/presentation/structure.md)]
+[!include[Structure](../includes/presentation/structure.md)]
## The Structure of the Comment Element
@@ -88,10 +88,10 @@ dotnet run -- [filePath] [initials] [name] [test ...]
> To get the exact author name and initials, open the presentation file and click the **File** menu item, and then click **Options**. The **PowerPointOptions** window opens and the content of the **General** tab is displayed. The author name and initials must match the **User name** and **Initials** in this tab.
### [CSharp](#tab/cs)
-[!code-csharp[](../samples/presentation/add_comment/cs/Program.cs)]
+[!code-csharp[](../../samples/presentation/add_comment/cs/Program.cs)]
### [Visual Basic](#tab/vb)
-[!code-vb[](../samples/presentation/add_comment/vb/Program.vb)]
+[!code-vb[](../../samples/presentation/add_comment/vb/Program.vb)]
## See also
diff --git a/docs/how-to-apply-a-theme-to-a-presentation.md b/docs/presentation/how-to-apply-a-theme-to-a-presentation.md
similarity index 99%
rename from docs/how-to-apply-a-theme-to-a-presentation.md
rename to docs/presentation/how-to-apply-a-theme-to-a-presentation.md
index 9456df1f..3a17e414 100644
--- a/docs/how-to-apply-a-theme-to-a-presentation.md
+++ b/docs/presentation/how-to-apply-a-theme-to-a-presentation.md
@@ -86,7 +86,7 @@ object that is created or named in the **using** statement, in this case **theme
-----------------------------------------------------------------------------
-[!include[Structure](./includes/presentation/structure.md)]
+[!include[Structure](../includes/presentation/structure.md)]
-----------------------------------------------------------------------------
## Structure of the Theme Element
@@ -103,7 +103,7 @@ be useful when working with this element.
> backgrounds, fills, and effects for different objects in a
> presentation. end example]
-
+
> In this example, we see how a theme can affect font, colors,
> backgrounds, fills, and effects for different objects in a
> presentation. *end example*]
diff --git a/docs/how-to-change-the-fill-color-of-a-shape-in-a-presentation.md b/docs/presentation/how-to-change-the-fill-color-of-a-shape-in-a-presentation.md
similarity index 97%
rename from docs/how-to-change-the-fill-color-of-a-shape-in-a-presentation.md
rename to docs/presentation/how-to-change-the-fill-color-of-a-shape-in-a-presentation.md
index ba90e7b8..5f8568ec 100644
--- a/docs/how-to-change-the-fill-color-of-a-shape-in-a-presentation.md
+++ b/docs/presentation/how-to-change-the-fill-color-of-a-shape-in-a-presentation.md
@@ -247,10 +247,10 @@ After running the program, examine the file "Myppt3.pptx" to see the
change in the fill color.
### [C#](#tab/cs)
-[!code-csharp[](../samples/presentation/change_the_fill_color_of_a_shape/cs/Program.cs)]
+[!code-csharp[](../../samples/presentation/change_the_fill_color_of_a_shape/cs/Program.cs)]
### [Visual Basic](#tab/vb)
-[!code-vb[](../samples/presentation/change_the_fill_color_of_a_shape/vb/Program.vb)]
+[!code-vb[](../../samples/presentation/change_the_fill_color_of_a_shape/vb/Program.vb)]
## See also
diff --git a/docs/how-to-create-a-presentation-document-by-providing-a-file-name.md b/docs/presentation/how-to-create-a-presentation-document-by-providing-a-file-name.md
similarity index 97%
rename from docs/how-to-create-a-presentation-document-by-providing-a-file-name.md
rename to docs/presentation/how-to-create-a-presentation-document-by-providing-a-file-name.md
index 2f4630be..70c65fdc 100644
--- a/docs/how-to-create-a-presentation-document-by-providing-a-file-name.md
+++ b/docs/presentation/how-to-create-a-presentation-document-by-providing-a-file-name.md
@@ -153,16 +153,16 @@ Following is the complete sample C\# and VB code to create a
presentation, given a file path.
### [C#](#tab/cs)
-[!code-csharp[](../samples/presentation/create_by_providing_a_file_name/cs/Program.cs)]
+[!code-csharp[](../../samples/presentation/create_by_providing_a_file_name/cs/Program.cs)]
### [Visual Basic](#tab/vb)
-[!code-vb[](../samples/presentation/create_by_providing_a_file_name/vb/Program.vb)]
+[!code-vb[](../../samples/presentation/create_by_providing_a_file_name/vb/Program.vb)]
--------------------------------------------------------------------------------
## See also
-[About the Open XML SDK for Office](about-the-open-xml-sdk.md)
+[About the Open XML SDK for Office](../about-the-open-xml-sdk.md)
[Structure of a PresentationML Document](structure-of-a-presentationml-document.md)
diff --git a/docs/how-to-delete-a-slide-from-a-presentation.md b/docs/presentation/how-to-delete-a-slide-from-a-presentation.md
similarity index 99%
rename from docs/how-to-delete-a-slide-from-a-presentation.md
rename to docs/presentation/how-to-delete-a-slide-from-a-presentation.md
index e2c9d45d..ca69910b 100644
--- a/docs/how-to-delete-a-slide-from-a-presentation.md
+++ b/docs/presentation/how-to-delete-a-slide-from-a-presentation.md
@@ -87,7 +87,7 @@ statement.
The **using** statement provides a recommended alternative to the typical .Open, .Save, .Close sequence. It ensures that the **Dispose** method (internal method used by the Open XML SDK to clean up resources) is automatically called when the closing brace is reached. The block that follows the **using** statement establishes a scope for the object that is created or named in the **using** statement, in this case **presentationDocument**.
-[!include[Structure](./includes/presentation/structure.md)]
+[!include[Structure](../includes/presentation/structure.md)]
## Counting the Number of Slides
diff --git a/docs/how-to-delete-all-the-comments-by-an-author-from-all-the-slides-in-a-presentatio.md b/docs/presentation/how-to-delete-all-the-comments-by-an-author-from-all-the-slides-in-a-presentatio.md
similarity index 99%
rename from docs/how-to-delete-all-the-comments-by-an-author-from-all-the-slides-in-a-presentatio.md
rename to docs/presentation/how-to-delete-all-the-comments-by-an-author-from-all-the-slides-in-a-presentatio.md
index ed86116f..edb1d5f8 100644
--- a/docs/how-to-delete-all-the-comments-by-an-author-from-all-the-slides-in-a-presentatio.md
+++ b/docs/presentation/how-to-delete-all-the-comments-by-an-author-from-all-the-slides-in-a-presentatio.md
@@ -81,7 +81,7 @@ used by the Open XML SDK to clean up resources) is automatically called
when the closing brace is reached. The block that follows the **using** statement establishes a scope for the
object that is created or named in the **using** statement, in this case *doc*.
-[!include[Structure](./includes/presentation/structure.md)]
+[!include[Structure](../includes/presentation/structure.md)]
## The Structure of the Comment Element
diff --git a/docs/how-to-get-all-the-external-hyperlinks-in-a-presentation.md b/docs/presentation/how-to-get-all-the-external-hyperlinks-in-a-presentation.md
similarity index 99%
rename from docs/how-to-get-all-the-external-hyperlinks-in-a-presentation.md
rename to docs/presentation/how-to-get-all-the-external-hyperlinks-in-a-presentation.md
index 1a073ebb..e8315dfe 100644
--- a/docs/how-to-get-all-the-external-hyperlinks-in-a-presentation.md
+++ b/docs/presentation/how-to-get-all-the-external-hyperlinks-in-a-presentation.md
@@ -79,7 +79,7 @@ object that is created or named in the **using** statement, in this case **docum
--------------------------------------------------------------------------------
-[!include[Structure](./includes/presentation/structure.md)]
+[!include[Structure](../includes/presentation/structure.md)]
--------------------------------------------------------------------------------
## Structure of the Hyperlink Element
diff --git a/docs/how-to-get-all-the-text-in-a-slide-in-a-presentation.md b/docs/presentation/how-to-get-all-the-text-in-a-slide-in-a-presentation.md
similarity index 99%
rename from docs/how-to-get-all-the-text-in-a-slide-in-a-presentation.md
rename to docs/presentation/how-to-get-all-the-text-in-a-slide-in-a-presentation.md
index ef3a4478..25fdda2e 100644
--- a/docs/how-to-get-all-the-text-in-a-slide-in-a-presentation.md
+++ b/docs/presentation/how-to-get-all-the-text-in-a-slide-in-a-presentation.md
@@ -81,7 +81,7 @@ object that is created or named in the **using** statement, in this case **prese
--------------------------------------------------------------------------------
-[!include[Structure](./includes/presentation/structure.md)]
+[!include[Structure](../includes/presentation/structure.md)]
## How the Sample Code Works
The sample code consists of three overloads of the **GetAllTextInSlide** method. In the following
diff --git a/docs/how-to-get-all-the-text-in-all-slides-in-a-presentation.md b/docs/presentation/how-to-get-all-the-text-in-all-slides-in-a-presentation.md
similarity index 99%
rename from docs/how-to-get-all-the-text-in-all-slides-in-a-presentation.md
rename to docs/presentation/how-to-get-all-the-text-in-all-slides-in-a-presentation.md
index a3bde9e7..c9788ed3 100644
--- a/docs/how-to-get-all-the-text-in-all-slides-in-a-presentation.md
+++ b/docs/presentation/how-to-get-all-the-text-in-all-slides-in-a-presentation.md
@@ -85,7 +85,7 @@ object that is created or named in the **using** statement, in this case **prese
--------------------------------------------------------------------------------
-[!include[Structure](./includes/presentation/structure.md)]
+[!include[Structure](../includes/presentation/structure.md)]
## How the Sample Code Works
The sample code starts by counting the number of slides in the
diff --git a/docs/how-to-get-the-titles-of-all-the-slides-in-a-presentation.md b/docs/presentation/how-to-get-the-titles-of-all-the-slides-in-a-presentation.md
similarity index 99%
rename from docs/how-to-get-the-titles-of-all-the-slides-in-a-presentation.md
rename to docs/presentation/how-to-get-the-titles-of-all-the-slides-in-a-presentation.md
index 936bcede..43368ea0 100644
--- a/docs/how-to-get-the-titles-of-all-the-slides-in-a-presentation.md
+++ b/docs/presentation/how-to-get-the-titles-of-all-the-slides-in-a-presentation.md
@@ -81,7 +81,7 @@ when the closing brace is reached. The block that follows the **using** statemen
object that is created or named in the **using** statement, in this case
*presentationDocument*.
-[!include[Structure](./includes/presentation/structure.md)]
+[!include[Structure](../includes/presentation/structure.md)]
## How the Sample Code Works
diff --git a/docs/how-to-insert-a-new-slide-into-a-presentation.md b/docs/presentation/how-to-insert-a-new-slide-into-a-presentation.md
similarity index 99%
rename from docs/how-to-insert-a-new-slide-into-a-presentation.md
rename to docs/presentation/how-to-insert-a-new-slide-into-a-presentation.md
index 0102142e..9cbbffc2 100644
--- a/docs/how-to-insert-a-new-slide-into-a-presentation.md
+++ b/docs/presentation/how-to-insert-a-new-slide-into-a-presentation.md
@@ -71,7 +71,7 @@ when the closing brace is reached. The block that follows the **using** statemen
object that is created or named in the **using** statement, in this case
*presentationDocument*.
-[!include[Structure](./includes/presentation/structure.md)]
+[!include[Structure](../includes/presentation/structure.md)]
## How the Sample Code Works
diff --git a/docs/how-to-move-a-paragraph-from-one-presentation-to-another.md b/docs/presentation/how-to-move-a-paragraph-from-one-presentation-to-another.md
similarity index 99%
rename from docs/how-to-move-a-paragraph-from-one-presentation-to-another.md
rename to docs/presentation/how-to-move-a-paragraph-from-one-presentation-to-another.md
index fbdf6c55..5f2b5363 100644
--- a/docs/how-to-move-a-paragraph-from-one-presentation-to-another.md
+++ b/docs/presentation/how-to-move-a-paragraph-from-one-presentation-to-another.md
@@ -71,7 +71,7 @@ used by the Open XML SDK to clean up resources) is automatically called
when the closing brace is reached. The block that follows the **using** statement establishes a scope for the
object that is created or named in the **using** statement, in this case *doc*.
-[!include[Structure](./includes/presentation/structure.md)]
+[!include[Structure](../includes/presentation/structure.md)]
## Structure of the Shape Text Body
diff --git a/docs/how-to-move-a-slide-to-a-new-position-in-a-presentation.md b/docs/presentation/how-to-move-a-slide-to-a-new-position-in-a-presentation.md
similarity index 99%
rename from docs/how-to-move-a-slide-to-a-new-position-in-a-presentation.md
rename to docs/presentation/how-to-move-a-slide-to-a-new-position-in-a-presentation.md
index 792eeadc..0f4455cb 100644
--- a/docs/how-to-move-a-slide-to-a-new-position-in-a-presentation.md
+++ b/docs/presentation/how-to-move-a-slide-to-a-new-position-in-a-presentation.md
@@ -79,7 +79,7 @@ object that is created or named in the **using** statement, in this case **prese
--------------------------------------------------------------------------------
-[!include[Structure](./includes/presentation/structure.md)]
+[!include[Structure](../includes/presentation/structure.md)]
## How the Sample Code Works
In order to move a specific slide in a presentation file to a new
diff --git a/docs/how-to-open-a-presentation-document-for-read-only-access.md b/docs/presentation/how-to-open-a-presentation-document-for-read-only-access.md
similarity index 99%
rename from docs/how-to-open-a-presentation-document-for-read-only-access.md
rename to docs/presentation/how-to-open-a-presentation-document-for-read-only-access.md
index 47661c3b..52fe587c 100644
--- a/docs/how-to-open-a-presentation-document-for-read-only-access.md
+++ b/docs/presentation/how-to-open-a-presentation-document-for-read-only-access.md
@@ -147,7 +147,7 @@ code segment performs this operation.
End Using
```
-[!include[Structure](./includes/presentation/structure.md)]
+[!include[Structure](../includes/presentation/structure.md)]
## How the Sample Code Works
diff --git a/docs/how-to-retrieve-the-number-of-slides-in-a-presentation-document.md b/docs/presentation/how-to-retrieve-the-number-of-slides-in-a-presentation-document.md
similarity index 97%
rename from docs/how-to-retrieve-the-number-of-slides-in-a-presentation-document.md
rename to docs/presentation/how-to-retrieve-the-number-of-slides-in-a-presentation-document.md
index b68881d7..4ad03a66 100644
--- a/docs/how-to-retrieve-the-number-of-slides-in-a-presentation-document.md
+++ b/docs/presentation/how-to-retrieve-the-number-of-slides-in-a-presentation-document.md
@@ -182,10 +182,10 @@ The following is the complete **RetrieveNumberOfSlides** code sample in C\# and
Visual Basic.
### [C#](#tab/cs)
-[!code-csharp[](../samples/presentation/retrieve_the_number_of_slides/cs/Program.cs)]
+[!code-csharp[](../../samples/presentation/retrieve_the_number_of_slides/cs/Program.cs)]
### [Visual Basic](#tab/vb)
-[!code-vb[](../samples/presentation/retrieve_the_number_of_slides/vb/Program.vb)]
+[!code-vb[](../../samples/presentation/retrieve_the_number_of_slides/vb/Program.vb)]
---------------------------------------------------------------------------------
diff --git a/docs/presentations.md b/docs/presentation/overview.md
similarity index 72%
rename from docs/presentations.md
rename to docs/presentation/overview.md
index ae9531f4..4eb6ec9d 100644
--- a/docs/presentations.md
+++ b/docs/presentation/overview.md
@@ -19,6 +19,8 @@ ms.localizationpriority: high
This section provides how-to topics for working with presentation documents using the Open XML SDK.
## In this section
+
+- [Structure of a PresentationML document (Open XML SDK)](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)
@@ -50,9 +52,23 @@ This section provides how-to topics for working with presentation documents usin
- [Retrieve the number of slides in a presentation document](how-to-retrieve-the-number-of-slides-in-a-presentation-document.md)
+- [Working with animation (Open XML SDK)](working-with-animation.md)
+
+- [Working with comments (Open XML SDK)](working-with-comments.md)
+
+- [Working with handout master slides (Open XML SDK)](working-with-handout-master-slides.md)
+
+- [Working with notes slides (Open XML SDK)](working-with-notes-slides.md)
+
+- [Working with presentations (Open XML SDK)](working-with-presentations.md)
+
+- [Working with presentation slides (Open XML SDK)](working-with-presentation-slides.md)
+
+- [Working with slide layouts (Open XML SDK)](working-with-slide-layouts.md)
+
+- [Working with slide masters (Open XML SDK)](working-with-slide-masters.md)
## Related sections
-- [How do I...](how-do-i.md)
-- [Getting started with the Open XML SDK for Office](getting-started.md)
+- [Getting started with the Open XML SDK for Office](../getting-started.md)
diff --git a/docs/structure-of-a-presentationml-document.md b/docs/presentation/structure-of-a-presentationml-document.md
similarity index 99%
rename from docs/structure-of-a-presentationml-document.md
rename to docs/presentation/structure-of-a-presentationml-document.md
index 180af233..92315060 100644
--- a/docs/structure-of-a-presentationml-document.md
+++ b/docs/presentation/structure-of-a-presentationml-document.md
@@ -618,7 +618,7 @@ Figure 1 shows the structure under the **ppt** folder of the .zip package for a
Figure 1. Minimum presentation folder structure
- 
+ 
The presentation.xml file contains \ (Slide) elements that reference the slides in the presentation. Each slide is associated to the presentation by means of a slide ID and a relationship ID. The **slideID** is the identifier (ID) used within the package to identify a slide and must be unique within the presentation. The **id** attribute is the relationship ID that identifies the slide part definition associated with a slide. For more information about the slide part, see [Working with presentation slides (Open XML SDK)](working-with-presentation-slides.md).
@@ -716,7 +716,7 @@ Figure 2 shows most of the elements that you would find in a typical presentatio
Figure 2. Elements of a PresentationML file
- 
+ 
## See also
diff --git a/docs/working-with-animation.md b/docs/presentation/working-with-animation.md
similarity index 99%
rename from docs/working-with-animation.md
rename to docs/presentation/working-with-animation.md
index 06cf37af..872a5949 100644
--- a/docs/working-with-animation.md
+++ b/docs/presentation/working-with-animation.md
@@ -138,7 +138,7 @@ The **Animate** class, which represents the \ element, is therefore also
## See also
-[About the Open XML SDK for Office](about-the-open-xml-sdk.md)
+[About the Open XML SDK for Office](../about-the-open-xml-sdk.md)
[How to: Create a Presentation by Providing a File Name](how-to-create-a-presentation-document-by-providing-a-file-name.md)
[How to: Insert a new slide into a presentation (Open XML SDK)](how-to-insert-a-new-slide-into-a-presentation.md)
[How to: Delete a slide from a presentation (Open XML SDK)](how-to-delete-a-slide-from-a-presentation.md)
diff --git a/docs/working-with-comments.md b/docs/presentation/working-with-comments.md
similarity index 99%
rename from docs/working-with-comments.md
rename to docs/presentation/working-with-comments.md
index aec9619f..63519172 100644
--- a/docs/working-with-comments.md
+++ b/docs/presentation/working-with-comments.md
@@ -271,7 +271,7 @@ article.
## See also
-[About the Open XML SDK for Office](about-the-open-xml-sdk.md)
+[About the Open XML SDK for Office](../about-the-open-xml-sdk.md)
[How to: Create a Presentation by Providing a File Name](how-to-create-a-presentation-document-by-providing-a-file-name.md)
[How to: Add a comment to a slide in a presentation (Open XML SDK)](how-to-add-a-comment-to-a-slide-in-a-presentation.md)
[How to: Delete all the comments by an author from all the slides in a presentation (Open XML SDK)](how-to-delete-all-the-comments-by-an-author-from-all-the-slides-in-a-presentatio.md)
diff --git a/docs/working-with-handout-master-slides.md b/docs/presentation/working-with-handout-master-slides.md
similarity index 99%
rename from docs/working-with-handout-master-slides.md
rename to docs/presentation/working-with-handout-master-slides.md
index 3bb9749f..bb338a0b 100644
--- a/docs/working-with-handout-master-slides.md
+++ b/docs/presentation/working-with-handout-master-slides.md
@@ -276,7 +276,7 @@ the PresentationML document referenced in the code.
## See also
-[About the Open XML SDK for Office](about-the-open-xml-sdk.md)
+[About the Open XML SDK for Office](../about-the-open-xml-sdk.md)
[How to: Create a presentation document by providing a file name (Open XML SDK)](how-to-create-a-presentation-document-by-providing-a-file-name.md)
[How to: Insert a new slide into a presentation (Open XML SDK)](how-to-insert-a-new-slide-into-a-presentation.md)
[How to: Delete a slide from a presentation (Open XML SDK)](how-to-delete-a-slide-from-a-presentation.md)
diff --git a/docs/working-with-notes-slides.md b/docs/presentation/working-with-notes-slides.md
similarity index 99%
rename from docs/working-with-notes-slides.md
rename to docs/presentation/working-with-notes-slides.md
index e927cfcb..bb56fb2d 100644
--- a/docs/working-with-notes-slides.md
+++ b/docs/presentation/working-with-notes-slides.md
@@ -275,7 +275,7 @@ the PresentationML document referenced in the code.
## See also
-[About the Open XML SDK for Office](about-the-open-xml-sdk.md)
+[About the Open XML SDK for Office](../about-the-open-xml-sdk.md)
[How to: Create a Presentation by Providing a File Name](how-to-create-a-presentation-document-by-providing-a-file-name.md)
diff --git a/docs/working-with-presentation-slides.md b/docs/presentation/working-with-presentation-slides.md
similarity index 99%
rename from docs/working-with-presentation-slides.md
rename to docs/presentation/working-with-presentation-slides.md
index 00fa3fee..39a7e8d1 100644
--- a/docs/working-with-presentation-slides.md
+++ b/docs/presentation/working-with-presentation-slides.md
@@ -323,7 +323,7 @@ is written to the PresentationML document file referenced in the code.
## See also
-[About the Open XML SDK for Office](about-the-open-xml-sdk.md)
+[About the Open XML SDK for Office](../about-the-open-xml-sdk.md)
[How to: Insert a new slide into a presentation (Open XML SDK)](how-to-insert-a-new-slide-into-a-presentation.md)
diff --git a/docs/working-with-presentations.md b/docs/presentation/working-with-presentations.md
similarity index 99%
rename from docs/working-with-presentations.md
rename to docs/presentation/working-with-presentations.md
index 731c9931..c8de06f7 100644
--- a/docs/working-with-presentations.md
+++ b/docs/presentation/working-with-presentations.md
@@ -430,7 +430,7 @@ PresentationML document referenced in the code.
## See also
-[About the Open XML SDK for Office](about-the-open-xml-sdk.md)
+[About the Open XML SDK for Office](../about-the-open-xml-sdk.md)
[How to: Create a presentation document by providing a file name (Open XML SDK)](how-to-create-a-presentation-document-by-providing-a-file-name.md)
diff --git a/docs/working-with-slide-layouts.md b/docs/presentation/working-with-slide-layouts.md
similarity index 99%
rename from docs/working-with-slide-layouts.md
rename to docs/presentation/working-with-slide-layouts.md
index fa21c417..c780d374 100644
--- a/docs/working-with-slide-layouts.md
+++ b/docs/presentation/working-with-slide-layouts.md
@@ -265,6 +265,6 @@ When the Open XML SDK code is run, the following XML is written to the Presentat
## See also
-[About the Open XML SDK for Office](about-the-open-xml-sdk.md)
+[About the Open XML SDK for Office](../about-the-open-xml-sdk.md)
[How to: Create a Presentation by Providing a File Name](how-to-create-a-presentation-document-by-providing-a-file-name.md)
[How to: Apply a theme to a presentation (Open XML SDK)](how-to-apply-a-theme-to-a-presentation.md)
diff --git a/docs/working-with-slide-masters.md b/docs/presentation/working-with-slide-masters.md
similarity index 99%
rename from docs/working-with-slide-masters.md
rename to docs/presentation/working-with-slide-masters.md
index 68d04584..e63a08e5 100644
--- a/docs/working-with-slide-masters.md
+++ b/docs/presentation/working-with-slide-masters.md
@@ -282,7 +282,7 @@ When the Open XML SDK code is run, the following XML is written to the Presentat
## See also
-[About the Open XML SDK for Office](about-the-open-xml-sdk.md)
+[About the Open XML SDK for Office](../about-the-open-xml-sdk.md)
[How to: Create a Presentation by Providing a File Name](how-to-create-a-presentation-document-by-providing-a-file-name.md)
[How to: Insert a new slide into a presentation (Open XML SDK)](how-to-insert-a-new-slide-into-a-presentation.md)
[How to: Delete a slide from a presentation (Open XML SDK)](how-to-delete-a-slide-from-a-presentation.md)
diff --git a/docs/how-to-add-custom-ui-to-a-spreadsheet-document.md b/docs/spreadsheet/how-to-add-custom-ui-to-a-spreadsheet-document.md
similarity index 98%
rename from docs/how-to-add-custom-ui-to-a-spreadsheet-document.md
rename to docs/spreadsheet/how-to-add-custom-ui-to-a-spreadsheet-document.md
index 26a788d2..7402759f 100644
--- a/docs/how-to-add-custom-ui-to-a-spreadsheet-document.md
+++ b/docs/spreadsheet/how-to-add-custom-ui-to-a-spreadsheet-document.md
@@ -170,10 +170,10 @@ Given a reference to the ribbon extensibility part, the following code finishes
The following is the complete **AddCustomUI** code sample in C\# and Visual Basic.
### [C#](#tab/cs)
-[!code-csharp[](../samples/spreadsheet/add_custom_ui/cs/Program.cs)]
+[!code-csharp[](../../samples/spreadsheet/add_custom_ui/cs/Program.cs)]
### [Visual Basic](#tab/vb)
-[!code-vb[](../samples/spreadsheet/add_custom_ui/vb/Program.vb)]
+[!code-vb[](../../samples/spreadsheet/add_custom_ui/vb/Program.vb)]
## See also
diff --git a/docs/how-to-calculate-the-sum-of-a-range-of-cells-in-a-spreadsheet-document.md b/docs/spreadsheet/how-to-calculate-the-sum-of-a-range-of-cells-in-a-spreadsheet-document.md
similarity index 99%
rename from docs/how-to-calculate-the-sum-of-a-range-of-cells-in-a-spreadsheet-document.md
rename to docs/spreadsheet/how-to-calculate-the-sum-of-a-range-of-cells-in-a-spreadsheet-document.md
index f8180093..8b6e0574 100644
--- a/docs/how-to-calculate-the-sum-of-a-range-of-cells-in-a-spreadsheet-document.md
+++ b/docs/spreadsheet/how-to-calculate-the-sum-of-a-range-of-cells-in-a-spreadsheet-document.md
@@ -62,7 +62,7 @@ The code that calls the **Open** method is shown in the following **using** stat
The **using** statement provides a recommended alternative to the typical .Open, .Save, .Close sequence. It ensures that the **Dispose** method (internal method used by the Open XML SDK to clean up resources) is automatically called when the closing brace is reached. The block that follows the **using** statement establishes a scope for the object that is created or named in the **using** statement, in this case **document**.
-[!include[Structure](./includes/spreadsheet/structure.md)]
+[!include[Structure](../includes/spreadsheet/structure.md)]
## How the Sample Code Works
diff --git a/docs/how-to-create-a-spreadsheet-document-by-providing-a-file-name.md b/docs/spreadsheet/how-to-create-a-spreadsheet-document-by-providing-a-file-name.md
similarity index 99%
rename from docs/how-to-create-a-spreadsheet-document-by-providing-a-file-name.md
rename to docs/spreadsheet/how-to-create-a-spreadsheet-document-by-providing-a-file-name.md
index 89db0be3..26a04179 100644
--- a/docs/how-to-create-a-spreadsheet-document-by-providing-a-file-name.md
+++ b/docs/spreadsheet/how-to-create-a-spreadsheet-document-by-providing-a-file-name.md
@@ -92,7 +92,7 @@ worksheet to the workbook.
sheets.Append(sheet)
```
-[!include[Structure](./includes/spreadsheet/structure.md)]
+[!include[Structure](../includes/spreadsheet/structure.md)]
## Generating the SpreadsheetML Markup
To create the basic document structure using the Open XML SDK,
diff --git a/docs/how-to-delete-text-from-a-cell-in-a-spreadsheet.md b/docs/spreadsheet/how-to-delete-text-from-a-cell-in-a-spreadsheet.md
similarity index 99%
rename from docs/how-to-delete-text-from-a-cell-in-a-spreadsheet.md
rename to docs/spreadsheet/how-to-delete-text-from-a-cell-in-a-spreadsheet.md
index fb57d40c..85130f1f 100644
--- a/docs/how-to-delete-text-from-a-cell-in-a-spreadsheet.md
+++ b/docs/spreadsheet/how-to-delete-text-from-a-cell-in-a-spreadsheet.md
@@ -67,7 +67,7 @@ used by the Open XML SDK to clean up resources) is automatically called
when the closing brace is reached. The block that follows the **using** statement establishes a scope for the
object that is created or named in the **using** statement, in this case *document*.
-[!include[Structure](./includes/spreadsheet/structure.md)]
+[!include[Structure](../includes/spreadsheet/structure.md)]
## How the sample code works
diff --git a/docs/how-to-get-a-column-heading-in-a-spreadsheet.md b/docs/spreadsheet/how-to-get-a-column-heading-in-a-spreadsheet.md
similarity index 99%
rename from docs/how-to-get-a-column-heading-in-a-spreadsheet.md
rename to docs/spreadsheet/how-to-get-a-column-heading-in-a-spreadsheet.md
index fa38b3ab..b008eaa6 100644
--- a/docs/how-to-get-a-column-heading-in-a-spreadsheet.md
+++ b/docs/spreadsheet/how-to-get-a-column-heading-in-a-spreadsheet.md
@@ -73,7 +73,7 @@ used by the Open XML SDK to clean up resources) is automatically called
when the closing brace is reached. The block that follows the **using** statement establishes a scope for the
object that is created or named in the **using** statement, in this case **mySpreadsheet**.
-[!include[Structure](./includes/spreadsheet/structure.md)]
+[!include[Structure](../includes/spreadsheet/structure.md)]
## How the Sample Code Works
diff --git a/docs/how-to-get-worksheet-information-from-a-package.md b/docs/spreadsheet/how-to-get-worksheet-information-from-a-package.md
similarity index 98%
rename from docs/how-to-get-worksheet-information-from-a-package.md
rename to docs/spreadsheet/how-to-get-worksheet-information-from-a-package.md
index 12e01bb8..cff4d0c7 100644
--- a/docs/how-to-get-worksheet-information-from-a-package.md
+++ b/docs/spreadsheet/how-to-get-worksheet-information-from-a-package.md
@@ -55,7 +55,7 @@ The following code example calls the **Open** method to open the file specified
The **using** statement provides a recommended alternative to the typical .Open, .Save, .Close sequence. It ensures that the **Dispose** method (internal method used by the Open XML SDK to clean up resources) is automatically called when the closing brace is reached. The block that follows the **using** statement establishes a scope for the object that is created or named in the **using** statement, in this case **mySpreadsheet**.
-[!include[Structure](./includes/spreadsheet/structure.md)]
+[!include[Structure](../includes/spreadsheet/structure.md)]
## How the Sample Code Works
diff --git a/docs/how-to-insert-a-chart-into-a-spreadsheet.md b/docs/spreadsheet/how-to-insert-a-chart-into-a-spreadsheet.md
similarity index 99%
rename from docs/how-to-insert-a-chart-into-a-spreadsheet.md
rename to docs/spreadsheet/how-to-insert-a-chart-into-a-spreadsheet.md
index 30c767da..84368e7d 100644
--- a/docs/how-to-insert-a-chart-into-a-spreadsheet.md
+++ b/docs/spreadsheet/how-to-insert-a-chart-into-a-spreadsheet.md
@@ -78,7 +78,7 @@ The code that calls the **Open** method is shown in the following **using** stat
The **using** statement provides a recommended alternative to the typical .Open, .Save, .Close sequence. It ensures that the **Dispose** method (internal method used by the Open XML SDK to clean up resources) is automatically called when the closing brace is reached. The block that follows the **using** statement establishes a scope for the object that is created or named in the **using** statement, in this case *document*.
-[!include[Structure](./includes/spreadsheet/structure.md)]
+[!include[Structure](../includes/spreadsheet/structure.md)]
## Row element
diff --git a/docs/how-to-insert-a-new-worksheet-into-a-spreadsheet.md b/docs/spreadsheet/how-to-insert-a-new-worksheet-into-a-spreadsheet.md
similarity index 98%
rename from docs/how-to-insert-a-new-worksheet-into-a-spreadsheet.md
rename to docs/spreadsheet/how-to-insert-a-new-worksheet-into-a-spreadsheet.md
index 5e426250..25e023e2 100644
--- a/docs/how-to-insert-a-new-worksheet-into-a-spreadsheet.md
+++ b/docs/spreadsheet/how-to-insert-a-new-worksheet-into-a-spreadsheet.md
@@ -146,10 +146,10 @@ inserts a worksheet in a file names "Sheet7.xslx," as an example.
Following is the complete sample code in both C\# and Visual Basic.
### [C#](#tab/cs)
-[!code-csharp[](../samples/spreadsheet/insert_a_new_worksheet/cs/Program.cs)]
+[!code-csharp[](../../samples/spreadsheet/insert_a_new_worksheet/cs/Program.cs)]
### [Visual Basic](#tab/vb)
-[!code-vb[](../samples/spreadsheet/insert_a_new_worksheet/vb/Program.vb)]
+[!code-vb[](../../samples/spreadsheet/insert_a_new_worksheet/vb/Program.vb)]
--------------------------------------------------------------------------------
## See also
diff --git a/docs/how-to-insert-text-into-a-cell-in-a-spreadsheet.md b/docs/spreadsheet/how-to-insert-text-into-a-cell-in-a-spreadsheet.md
similarity index 99%
rename from docs/how-to-insert-text-into-a-cell-in-a-spreadsheet.md
rename to docs/spreadsheet/how-to-insert-text-into-a-cell-in-a-spreadsheet.md
index 24d9ebd3..a9a0852d 100644
--- a/docs/how-to-insert-text-into-a-cell-in-a-spreadsheet.md
+++ b/docs/spreadsheet/how-to-insert-text-into-a-cell-in-a-spreadsheet.md
@@ -81,7 +81,7 @@ used by the Open XML SDK to clean up resources) is automatically called
when the closing brace is reached. The block that follows the **using** statement establishes a scope for the
object that is created or named in the **using** statement, in this case *spreadSheet*.
-[!include[Structure](./includes/spreadsheet/structure.md)]
+[!include[Structure](../includes/spreadsheet/structure.md)]
## How the Sample Code Works
After opening the **SpreadsheetDocument**
diff --git a/docs/how-to-merge-two-adjacent-cells-in-a-spreadsheet.md b/docs/spreadsheet/how-to-merge-two-adjacent-cells-in-a-spreadsheet.md
similarity index 98%
rename from docs/how-to-merge-two-adjacent-cells-in-a-spreadsheet.md
rename to docs/spreadsheet/how-to-merge-two-adjacent-cells-in-a-spreadsheet.md
index 0f56e79d..993c4ef3 100644
--- a/docs/how-to-merge-two-adjacent-cells-in-a-spreadsheet.md
+++ b/docs/spreadsheet/how-to-merge-two-adjacent-cells-in-a-spreadsheet.md
@@ -156,10 +156,10 @@ named "Jane," in a file named "Sheet9.xlsx."
The following is the complete sample code in both C\# and Visual Basic.
### [C#](#tab/cs)
-[!code-csharp[](../samples/spreadsheet/merge_two_adjacent_cells/cs/Program.cs)]
+[!code-csharp[](../../samples/spreadsheet/merge_two_adjacent_cells/cs/Program.cs)]
### [Visual Basic](#tab/vb)
-[!code-vb[](../samples/spreadsheet/merge_two_adjacent_cells/vb/Program.vb)]
+[!code-vb[](../../samples/spreadsheet/merge_two_adjacent_cells/vb/Program.vb)]
--------------------------------------------------------------------------------
## See also
diff --git a/docs/how-to-open-a-spreadsheet-document-for-read-only-access.md b/docs/spreadsheet/how-to-open-a-spreadsheet-document-for-read-only-access.md
similarity index 98%
rename from docs/how-to-open-a-spreadsheet-document-for-read-only-access.md
rename to docs/spreadsheet/how-to-open-a-spreadsheet-document-for-read-only-access.md
index d9091131..79712496 100644
--- a/docs/how-to-open-a-spreadsheet-document-for-read-only-access.md
+++ b/docs/spreadsheet/how-to-open-a-spreadsheet-document-for-read-only-access.md
@@ -218,10 +218,10 @@ the following code, which opens the file "Sheet10.xlsx," as an example.
The following is the complete sample code in both C\# and Visual Basic.
### [C#](#tab/cs)
-[!code-csharp[](../samples/spreadsheet/open_for_read_only_access/cs/Program.cs)]
+[!code-csharp[](../../samples/spreadsheet/open_for_read_only_access/cs/Program.cs)]
### [Visual Basic](#tab/vb)
-[!code-vb[](../samples/spreadsheet/open_for_read_only_access/vb/Program.vb)]
+[!code-vb[](../../samples/spreadsheet/open_for_read_only_access/vb/Program.vb)]
--------------------------------------------------------------------------------
## See also
diff --git a/docs/how-to-open-a-spreadsheet-document-from-a-stream.md b/docs/spreadsheet/how-to-open-a-spreadsheet-document-from-a-stream.md
similarity index 98%
rename from docs/how-to-open-a-spreadsheet-document-from-a-stream.md
rename to docs/spreadsheet/how-to-open-a-spreadsheet-document-from-a-stream.md
index d041c4a3..36cf4b37 100644
--- a/docs/how-to-open-a-spreadsheet-document-from-a-stream.md
+++ b/docs/spreadsheet/how-to-open-a-spreadsheet-document-from-a-stream.md
@@ -188,10 +188,10 @@ close the stream passed to it. The calling code must do that.
The following is the complete sample code in both C\# and Visual Basic.
### [C#](#tab/cs)
-[!code-csharp[](../samples/spreadsheet/open_from_a_stream/cs/Program.cs)]
+[!code-csharp[](../../samples/spreadsheet/open_from_a_stream/cs/Program.cs)]
### [Visual Basic](#tab/vb)
-[!code-vb[](../samples/spreadsheet/open_from_a_stream/vb/Program.vb)]
+[!code-vb[](../../samples/spreadsheet/open_from_a_stream/vb/Program.vb)]
--------------------------------------------------------------------------------
## See also
diff --git a/docs/how-to-parse-and-read-a-large-spreadsheet.md b/docs/spreadsheet/how-to-parse-and-read-a-large-spreadsheet.md
similarity index 96%
rename from docs/how-to-parse-and-read-a-large-spreadsheet.md
rename to docs/spreadsheet/how-to-parse-and-read-a-large-spreadsheet.md
index 82400019..6f45c51e 100644
--- a/docs/how-to-parse-and-read-a-large-spreadsheet.md
+++ b/docs/spreadsheet/how-to-parse-and-read-a-large-spreadsheet.md
@@ -20,7 +20,7 @@ This topic shows how to use the classes in the Open XML SDK for
Office to programmatically read a large Excel file. For more information
about the basic structure of a **SpreadsheetML** document, see [Structure of a SpreadsheetML document (Open XML SDK)](structure-of-a-spreadsheetml-document.md).
-[!include[Add-ins note](./includes/addinsnote.md)]
+[!include[Add-ins note](../includes/addinsnote.md)]
You must use the following **using** directives
or **Imports** statements to compile the code
@@ -184,10 +184,10 @@ exclude.
The following is the complete code sample in both C\# and Visual Basic.
### [C#](#tab/cs)
-[!code-csharp[](../samples/spreadsheet/parse_and_read_a_large_spreadsheet/cs/Program.cs)]
+[!code-csharp[](../../samples/spreadsheet/parse_and_read_a_large_spreadsheet/cs/Program.cs)]
### [Visual Basic](#tab/vb)
-[!code-vb[](../samples/spreadsheet/parse_and_read_a_large_spreadsheet/vb/Program.vb)]
+[!code-vb[](../../samples/spreadsheet/parse_and_read_a_large_spreadsheet/vb/Program.vb)]
--------------------------------------------------------------------------------
## See also
diff --git a/docs/how-to-retrieve-a-dictionary-of-all-named-ranges-in-a-spreadsheet.md b/docs/spreadsheet/how-to-retrieve-a-dictionary-of-all-named-ranges-in-a-spreadsheet.md
similarity index 97%
rename from docs/how-to-retrieve-a-dictionary-of-all-named-ranges-in-a-spreadsheet.md
rename to docs/spreadsheet/how-to-retrieve-a-dictionary-of-all-named-ranges-in-a-spreadsheet.md
index 83853c58..e58af400 100644
--- a/docs/how-to-retrieve-a-dictionary-of-all-named-ranges-in-a-spreadsheet.md
+++ b/docs/spreadsheet/how-to-retrieve-a-dictionary-of-all-named-ranges-in-a-spreadsheet.md
@@ -172,10 +172,10 @@ defined names that are contained within the workbook. If the property returns a
The following is the complete **GetDefinedNames** code sample in C\# and Visual Basic.
### [C#](#tab/cs)
-[!code-csharp[](../samples/spreadsheet/retrieve_a_dictionary_of_all_named_ranges/cs/Program.cs)]
+[!code-csharp[](../../samples/spreadsheet/retrieve_a_dictionary_of_all_named_ranges/cs/Program.cs)]
### [Visual Basic](#tab/vb)
-[!code-vb[](../samples/spreadsheet/retrieve_a_dictionary_of_all_named_ranges/vb/Program.vb)]
+[!code-vb[](../../samples/spreadsheet/retrieve_a_dictionary_of_all_named_ranges/vb/Program.vb)]
## See also
diff --git a/docs/how-to-retrieve-a-list-of-the-hidden-rows-or-columns-in-a-spreadsheet.md b/docs/spreadsheet/how-to-retrieve-a-list-of-the-hidden-rows-or-columns-in-a-spreadsheet.md
similarity index 98%
rename from docs/how-to-retrieve-a-list-of-the-hidden-rows-or-columns-in-a-spreadsheet.md
rename to docs/spreadsheet/how-to-retrieve-a-list-of-the-hidden-rows-or-columns-in-a-spreadsheet.md
index 30c841ca..d12f5b82 100644
--- a/docs/how-to-retrieve-a-list-of-the-hidden-rows-or-columns-in-a-spreadsheet.md
+++ b/docs/spreadsheet/how-to-retrieve-a-list-of-the-hidden-rows-or-columns-in-a-spreadsheet.md
@@ -253,10 +253,10 @@ Retrieving the list of hidden columns is a bit trickier, because Excel collapses
The following is the complete **GetHiddenRowsOrCols** code sample in C\# and Visual Basic.
### [C#](#tab/cs)
-[!code-csharp[](../samples/spreadsheet/retrieve_a_list_of_the_hidden_rows_or_columns/cs/Program.cs)]
+[!code-csharp[](../../samples/spreadsheet/retrieve_a_list_of_the_hidden_rows_or_columns/cs/Program.cs)]
### [Visual Basic](#tab/vb)
-[!code-vb[](../samples/spreadsheet/retrieve_a_list_of_the_hidden_rows_or_columns/vb/Program.vb)]
+[!code-vb[](../../samples/spreadsheet/retrieve_a_list_of_the_hidden_rows_or_columns/vb/Program.vb)]
---------------------------------------------------------------------------------
diff --git a/docs/how-to-retrieve-a-list-of-the-hidden-worksheets-in-a-spreadsheet.md b/docs/spreadsheet/how-to-retrieve-a-list-of-the-hidden-worksheets-in-a-spreadsheet.md
similarity index 97%
rename from docs/how-to-retrieve-a-list-of-the-hidden-worksheets-in-a-spreadsheet.md
rename to docs/spreadsheet/how-to-retrieve-a-list-of-the-hidden-worksheets-in-a-spreadsheet.md
index 3515cfac..01b2b812 100644
--- a/docs/how-to-retrieve-a-list-of-the-hidden-worksheets-in-a-spreadsheet.md
+++ b/docs/spreadsheet/how-to-retrieve-a-list-of-the-hidden-worksheets-in-a-spreadsheet.md
@@ -158,10 +158,10 @@ Finally, the following code calls the **[ToList\](https://msdn2.micros
The following is the complete **GetHiddenSheets** code sample in C\# and Visual Basic.
### [C#](#tab/cs)
-[!code-csharp[](../samples/spreadsheet/retrieve_a_list_of_the_hidden_worksheets/cs/Program.cs)]
+[!code-csharp[](../../samples/spreadsheet/retrieve_a_list_of_the_hidden_worksheets/cs/Program.cs)]
### [Visual Basic](#tab/vb)
-[!code-vb[](../samples/spreadsheet/retrieve_a_list_of_the_hidden_worksheets/vb/Program.vb)]
+[!code-vb[](../../samples/spreadsheet/retrieve_a_list_of_the_hidden_worksheets/vb/Program.vb)]
## See also
diff --git a/docs/how-to-retrieve-a-list-of-the-worksheets-in-a-spreadsheet.md b/docs/spreadsheet/how-to-retrieve-a-list-of-the-worksheets-in-a-spreadsheet.md
similarity index 96%
rename from docs/how-to-retrieve-a-list-of-the-worksheets-in-a-spreadsheet.md
rename to docs/spreadsheet/how-to-retrieve-a-list-of-the-worksheets-in-a-spreadsheet.md
index b490d436..fa6f094d 100644
--- a/docs/how-to-retrieve-a-list-of-the-worksheets-in-a-spreadsheet.md
+++ b/docs/spreadsheet/how-to-retrieve-a-list-of-the-worksheets-in-a-spreadsheet.md
@@ -161,10 +161,10 @@ The following is the complete **GetAllWorksheets** code sample in C\# and Visual
Basic.
### [C#](#tab/cs)
-[!code-csharp[](../samples/spreadsheet/retrieve_a_list_of_the_worksheets/cs/Program.cs)]
+[!code-csharp[](../../samples/spreadsheet/retrieve_a_list_of_the_worksheets/cs/Program.cs)]
### [Visual Basic](#tab/vb)
-[!code-vb[](../samples/spreadsheet/retrieve_a_list_of_the_worksheets/vb/Program.vb)]
+[!code-vb[](../../samples/spreadsheet/retrieve_a_list_of_the_worksheets/vb/Program.vb)]
--------------------------------------------------------------------------------
diff --git a/docs/how-to-retrieve-the-values-of-cells-in-a-spreadsheet.md b/docs/spreadsheet/how-to-retrieve-the-values-of-cells-in-a-spreadsheet.md
similarity index 98%
rename from docs/how-to-retrieve-the-values-of-cells-in-a-spreadsheet.md
rename to docs/spreadsheet/how-to-retrieve-the-values-of-cells-in-a-spreadsheet.md
index c118e801..be893186 100644
--- a/docs/how-to-retrieve-the-values-of-cells-in-a-spreadsheet.md
+++ b/docs/spreadsheet/how-to-retrieve-the-values-of-cells-in-a-spreadsheet.md
@@ -371,10 +371,10 @@ Finally, the procedure returns the variable **value**, which contains the reques
The following is the complete **GetCellValue** code sample in C\# and Visual Basic.
### [C#](#tab/cs)
-[!code-csharp[](../samples/spreadsheet/retrieve_the_values_of_cells/cs/Program.cs)]
+[!code-csharp[](../../samples/spreadsheet/retrieve_the_values_of_cells/cs/Program.cs)]
### [Visual Basic](#tab/vb)
-[!code-vb[](../samples/spreadsheet/retrieve_the_values_of_cells/vb/Program.vb)]
+[!code-vb[](../../samples/spreadsheet/retrieve_the_values_of_cells/vb/Program.vb)]
## See also
diff --git a/docs/spreadsheets.md b/docs/spreadsheet/overview.md
similarity index 75%
rename from docs/spreadsheets.md
rename to docs/spreadsheet/overview.md
index 11a87a68..372abafb 100644
--- a/docs/spreadsheets.md
+++ b/docs/spreadsheet/overview.md
@@ -21,6 +21,22 @@ This section provides how-to topics for working with spreadsheet documents using
## In this section
+- [Structure of a SpreadsheetML document (Open XML SDK)](structure-of-a-spreadsheetml-document.md)
+
+- [Working with the calculation chain (Open XML SDK)](working-with-the-calculation-chain.md)
+
+- [Working with conditional formatting (Open XML SDK)](working-with-conditional-formatting.md)
+
+- [Working with formulas (Open XML SDK)](working-with-formulas.md)
+
+- [Working with PivotTables (Open XML SDK)](working-with-pivottables.md)
+
+- [Working with the shared string table (Open XML SDK)](working-with-the-shared-string-table.md)
+
+- [Working with sheets (Open XML SDK)](working-with-sheets.md)
+
+- [Working with SpreadsheetML tables (Open XML SDK)](working-with-tables.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)
- [Create a spreadsheet document by providing a file name](how-to-create-a-spreadsheet-document-by-providing-a-file-name.md)
@@ -56,5 +72,4 @@ This section provides how-to topics for working with spreadsheet documents using
## Related sections
-- [How do I...](how-do-i.md)
-- [Getting started with the Open XML SDK for Office](getting-started.md)
+- [Getting started with the Open XML SDK for Office](../getting-started.md)
diff --git a/docs/structure-of-a-spreadsheetml-document.md b/docs/spreadsheet/structure-of-a-spreadsheetml-document.md
similarity index 97%
rename from docs/structure-of-a-spreadsheetml-document.md
rename to docs/spreadsheet/structure-of-a-spreadsheetml-document.md
index 2cee3bed..0f3bb6d8 100644
--- a/docs/structure-of-a-spreadsheetml-document.md
+++ b/docs/spreadsheet/structure-of-a-spreadsheetml-document.md
@@ -26,7 +26,7 @@ spreadsheet document. In addition, a spreadsheet document might contain
\<**table**\>, \<**chartsheet**\>, \<**pivotTableDefinition**\>, or other spreadsheet
related elements.
-[!include[Add-ins note](./includes/addinsnote.md)]
+[!include[Add-ins note](../includes/addinsnote.md)]
--------------------------------------------------------------------------------
## Important Spreadsheet Parts
@@ -43,7 +43,7 @@ some of the important spreadsheet elements.
| Workbook | workbook | [Workbook](https://msdn.microsoft.com/library/office/documentformat.openxml.spreadsheet.workbook.aspx) | The root element for the main document part.|
| Worksheet | worksheet | [Worksheet](https://msdn.microsoft.com/library/office/documentformat.openxml.spreadsheet.worksheet.aspx) | A type of sheet that represent a grid of cells that contains text, numbers, dates or formulas. For more information, see [Working with sheets (Open XML SDK)](working-with-sheets.md). |
|Chart Sheet | chartsheet | [Chartsheet](https://msdn.microsoft.com/library/office/documentformat.openxml.spreadsheet.chartsheet.aspx) | A sheet that represents a chart that is stored as its own sheet. For more information, see [Working with sheets (Open XML SDK)](working-with-sheets.md). |
-| Table | table | [Table](https://msdn.microsoft.com/library/office/documentformat.openxml.spreadsheet.table.aspx) | A logical construct that specifies that a range of data belongs to a single dataset. For more information, see [Working with SpreadsheetML tables (Open XML SDK)](working-with-spreadsheetml-documents.md). |
+| Table | table | [Table](https://msdn.microsoft.com/library/office/documentformat.openxml.spreadsheet.table.aspx) | A logical construct that specifies that a range of data belongs to a single dataset. For more information, see [Working with SpreadsheetML tables (Open XML SDK)](overview.md). |
|Pivot Table | [pivotTableDefinition](https://msdn.microsoft.com/library/office/documentformat.openxml.spreadsheet.pivottabledefinition.aspx) | [PivotTableDefinition](https://msdn.microsoft.com/library/office/documentformat.openxml.spreadsheet.pivottabledefinition.aspx) | A logical construct that displays aggregated view of data in an understandable layout. For more information, see [Working with PivotTables (Open XML SDK)](working-with-pivottables.md). |
|Pivot Cache | pivotCacheDefinition | [PivotCacheDefinition](https://msdn.microsoft.com/library/office/documentformat.openxml.spreadsheet.pivotcachedefinition.aspx) | A construct that defines the source of the data in the PivotTable. For more information, see [Working with PivotTables (Open XML SDK)](working-with-pivottables.md). |
|Pivot Cache Records | pivotCacheRecords | [PivotCacheRecords](https://msdn.microsoft.com/library/office/documentformat.openxml.spreadsheet.pivotcacherecords.aspx) | A cache of the source data of the PivotTable. For more information, see [Working with PivotTables (Open XML SDK)](working-with-pivottables.md). |
@@ -149,7 +149,7 @@ workbook.
Figure 1. .zip folder structure
- 
+ 
The **workbook.xml** file contains \<**sheet**\> elements that reference the worksheets in
the workbook. Each worksheet is associated to the workbook via a Sheet
ID and a relationship ID. The **sheetID** is
@@ -214,4 +214,4 @@ typical spreadsheet.
Figure 2. Typical spreadsheet elements
- 
+ 
diff --git a/docs/working-with-conditional-formatting.md b/docs/spreadsheet/working-with-conditional-formatting.md
similarity index 100%
rename from docs/working-with-conditional-formatting.md
rename to docs/spreadsheet/working-with-conditional-formatting.md
diff --git a/docs/working-with-formulas.md b/docs/spreadsheet/working-with-formulas.md
similarity index 100%
rename from docs/working-with-formulas.md
rename to docs/spreadsheet/working-with-formulas.md
diff --git a/docs/working-with-pivottables.md b/docs/spreadsheet/working-with-pivottables.md
similarity index 100%
rename from docs/working-with-pivottables.md
rename to docs/spreadsheet/working-with-pivottables.md
diff --git a/docs/working-with-sheets.md b/docs/spreadsheet/working-with-sheets.md
similarity index 100%
rename from docs/working-with-sheets.md
rename to docs/spreadsheet/working-with-sheets.md
diff --git a/docs/working-with-tables.md b/docs/spreadsheet/working-with-tables.md
similarity index 100%
rename from docs/working-with-tables.md
rename to docs/spreadsheet/working-with-tables.md
diff --git a/docs/working-with-the-calculation-chain.md b/docs/spreadsheet/working-with-the-calculation-chain.md
similarity index 100%
rename from docs/working-with-the-calculation-chain.md
rename to docs/spreadsheet/working-with-the-calculation-chain.md
diff --git a/docs/working-with-the-shared-string-table.md b/docs/spreadsheet/working-with-the-shared-string-table.md
similarity index 100%
rename from docs/working-with-the-shared-string-table.md
rename to docs/spreadsheet/working-with-the-shared-string-table.md
diff --git a/docs/toc.yml b/docs/toc.yml
index 044997ff..1b0ae262 100644
--- a/docs/toc.yml
+++ b/docs/toc.yml
@@ -12,217 +12,197 @@
href: what-s-new-in-the-open-xml-sdk.md
- name: Open XML SDK design considerations
href: open-xml-sdk-design-considerations.md
- - name: Understanding the Open XML file formats
+ - name: General
items:
- name: Overview
- href: understanding-the-open-xml-file-formats.md
+ href: general/overview.md
- name: Introduction to markup compatibility
- href: introduction-to-markup-compatibility.md
- - name: Working with PresentationML documents
- items:
- - name: Overview
- href: working-with-presentationml-documents.md
- - name: Structure of a PresentationML document
- href: structure-of-a-presentationml-document.md
- - name: Working with animation
- href: working-with-animation.md
- - name: Working with comments
- href: working-with-comments.md
- - name: Working with handout master slides
- href: working-with-handout-master-slides.md
- - name: Working with notes slides
- href: working-with-notes-slides.md
- - name: Working with presentations
- href: working-with-presentations.md
- - name: Working with presentation slides
- href: working-with-presentation-slides.md
- - name: Working with slide layouts
- href: working-with-slide-layouts.md
- - name: Working with slide masters
- href: working-with-slide-masters.md
- - name: Working with SpreadsheetML documents
- items:
- - name: Overview
- href: working-with-spreadsheetml-documents.md
- - name: Structure of a SpreadsheetML document
- href: structure-of-a-spreadsheetml-document.md
- - name: Working with the calculation chain
- href: working-with-the-calculation-chain.md
- - name: Working with conditional formatting
- href: working-with-conditional-formatting.md
- - name: Working with formulas
- href: working-with-formulas.md
- - name: Working with PivotTables
- href: working-with-pivottables.md
- - name: Working with the shared string table
- href: working-with-the-shared-string-table.md
- - name: Working with sheets
- href: working-with-sheets.md
- - name: Working with tables
- href: working-with-tables.md
- - name: Working with WordprocessingML documents
- items:
- - name: Overview
- href: working-with-wordprocessingml-documents.md
- - name: Structure of a WordprocessingML document
- href: structure-of-a-wordprocessingml-document.md
- - name: Working with paragraphs
- href: working-with-paragraphs.md
- - name: Working with runs
- href: working-with-runs.md
- - name: Working with WordprocessingML tables
- href: working-with-wordprocessingml-tables.md
- - name: How do I...
+ href: general/introduction-to-markup-compatibility.md
+ - name: Add a new document part that receives a relationship ID to a package
+ href: general/how-to-add-a-new-document-part-that-receives-a-relationship-id-to-a-package.md
+ - name: Add a new document part to a package
+ href: general/how-to-add-a-new-document-part-to-a-package.md
+ - name: Copy the contents of an Open XML package part to a document part in a different package
+ href: general/how-to-copy-the-contents-of-an-open-xml-package-part-to-a-document-part-in-a-dif.md
+ - name: Create a package
+ href: general/how-to-create-a-package.md
+ - name: Get the contents of a document part from a package
+ href: general/how-to-get-the-contents-of-a-document-part-from-a-package.md
+ - name: Remove a document part from a package
+ href: general/how-to-remove-a-document-part-from-a-package.md
+ - name: Replace the theme part in a word processing document
+ href: general/how-to-replace-the-theme-part-in-a-word-processing-document.md
+ - name: Search and replace text in a document part
+ href: general/how-to-search-and-replace-text-in-a-document-part.md
+ - name: Presentations
items:
- name: Overview
- href: how-do-i.md
- - name: Presentations
- items:
- - name: Overview
- href: presentations.md
- - name: Add a comment to a slide in a presentation
- href: how-to-add-a-comment-to-a-slide-in-a-presentation.md
- - name: Apply a theme to a presentation
- href: how-to-apply-a-theme-to-a-presentation.md
- - name: Change the fill color of a shape in a presentation
- href: how-to-change-the-fill-color-of-a-shape-in-a-presentation.md
- - name: Create a presentation document by providing a file name
- href: how-to-create-a-presentation-document-by-providing-a-file-name.md
- - name: Delete all the comments by an author from all the slides in a presentation
- href: how-to-delete-all-the-comments-by-an-author-from-all-the-slides-in-a-presentatio.md
- - name: Delete a slide from a presentation
- href: how-to-delete-a-slide-from-a-presentation.md
- - name: Get all the external hyperlinks in a presentation
- href: how-to-get-all-the-external-hyperlinks-in-a-presentation.md
- - name: Get all the text in a slide in a presentation
- href: how-to-get-all-the-text-in-a-slide-in-a-presentation.md
- - name: Get all the text in all slides in a presentation
- href: how-to-get-all-the-text-in-all-slides-in-a-presentation.md
- - name: Get the titles of all the slides in a presentation
- href: how-to-get-the-titles-of-all-the-slides-in-a-presentation.md
- - name: Insert a new slide into a presentation
- href: how-to-insert-a-new-slide-into-a-presentation.md
- - name: Move a slide to a new position in a presentation
- href: how-to-move-a-slide-to-a-new-position-in-a-presentation.md
- - name: Move a paragraph from one presentation to another
- href: how-to-move-a-paragraph-from-one-presentation-to-another.md
- - name: Open a presentation document for read-only access
- href: how-to-open-a-presentation-document-for-read-only-access.md
- - name: Retrieve the number of slides in a presentation document
- href: how-to-retrieve-the-number-of-slides-in-a-presentation-document.md
- - name: Packages and general
- items:
- - name: Overview
- href: packages-and-general.md
- - name: Add a new document part that receives a relationship ID to a package
- href: how-to-add-a-new-document-part-that-receives-a-relationship-id-to-a-package.md
- - name: Add a new document part to a package
- href: how-to-add-a-new-document-part-to-a-package.md
- - name: Copy the contents of an Open XML package part to a document part in a different package
- href: how-to-copy-the-contents-of-an-open-xml-package-part-to-a-document-part-in-a-dif.md
- - name: Create a package
- href: how-to-create-a-package.md
- - name: Get the contents of a document part from a package
- href: how-to-get-the-contents-of-a-document-part-from-a-package.md
- - name: Remove a document part from a package
- href: how-to-remove-a-document-part-from-a-package.md
- - name: Replace the theme part in a word processing document
- href: how-to-replace-the-theme-part-in-a-word-processing-document.md
- - name: Search and replace text in a document part
- href: how-to-search-and-replace-text-in-a-document-part.md
- - name: Spreadsheets
- items:
- - name: Overview
- href: spreadsheets.md
- - name: Add custom UI to a spreadsheet document
- href: how-to-add-custom-ui-to-a-spreadsheet-document.md
- - name: Calculate the sum of a range of cells in a spreadsheet document
- href: how-to-calculate-the-sum-of-a-range-of-cells-in-a-spreadsheet-document.md
- - name: Create a spreadsheet document by providing a file name
- href: how-to-create-a-spreadsheet-document-by-providing-a-file-name.md
- - name: Delete text from a cell in a spreadsheet
- href: how-to-delete-text-from-a-cell-in-a-spreadsheet.md
- - name: Get a column heading in a spreadsheet
- href: how-to-get-a-column-heading-in-a-spreadsheet.md
- - name: Get worksheet information from a package
- href: how-to-get-worksheet-information-from-a-package.md
- - name: Insert a chart into a spreadsheet
- href: how-to-insert-a-chart-into-a-spreadsheet.md
- - name: Insert a new worksheet into a spreadsheet
- href: how-to-insert-a-new-worksheet-into-a-spreadsheet.md
- - name: Insert text into a cell in a spreadsheet
- href: how-to-insert-text-into-a-cell-in-a-spreadsheet.md
- - name: Merge two adjacent cells in a spreadsheet
- href: how-to-merge-two-adjacent-cells-in-a-spreadsheet.md
- - name: Open a spreadsheet document for read-only access
- href: how-to-open-a-spreadsheet-document-for-read-only-access.md
- - name: Open a spreadsheet document from a stream
- href: how-to-open-a-spreadsheet-document-from-a-stream.md
- - name: Parse and read a large spreadsheet
- href: how-to-parse-and-read-a-large-spreadsheet.md
- - name: Retrieve a dictionary of all named ranges in a spreadsheet
- href: how-to-retrieve-a-dictionary-of-all-named-ranges-in-a-spreadsheet.md
- - name: Retrieve a list of the hidden rows or columns in a spreadsheet
- href: how-to-retrieve-a-list-of-the-hidden-rows-or-columns-in-a-spreadsheet.md
- - name: Retrieve a list of the hidden worksheets in a spreadsheet
- href: how-to-retrieve-a-list-of-the-hidden-worksheets-in-a-spreadsheet.md
- - name: Retrieve the values of cells in a spreadsheet
- href: how-to-retrieve-the-values-of-cells-in-a-spreadsheet.md
- - name: Retrieve a list of the worksheets in a spreadsheet
- href: how-to-retrieve-a-list-of-the-worksheets-in-a-spreadsheet.md
- - name: Word processing
- items:
- - name: Overview
- href: word-processing.md
- - name: Accept all revisions in a word processing document
- href: how-to-accept-all-revisions-in-a-word-processing-document.md
- - name: Add tables to word processing documents
- href: how-to-add-tables-to-word-processing-documents.md
- - name: Apply a style to a paragraph in a word processing document
- href: how-to-apply-a-style-to-a-paragraph-in-a-word-processing-document.md
- - name: Change the print orientation of a word processing document
- href: how-to-change-the-print-orientation-of-a-word-processing-document.md
- - name: Change text in a table in a word processing document
- href: how-to-change-text-in-a-table-in-a-word-processing-document.md
- - name: Convert a word processing document from the DOCM to the DOCX file format
- href: how-to-convert-a-word-processing-document-from-the-docm-to-the-docx-file-format.md
- - name: Create and add a character style to a word processing document
- href: how-to-create-and-add-a-character-style-to-a-word-processing-document.md
- - name: Create and add a paragraph style to a word processing document
- href: how-to-create-and-add-a-paragraph-style-to-a-word-processing-document.md
- - name: Create a word processing document by providing a file name
- href: how-to-create-a-word-processing-document-by-providing-a-file-name.md
- - name: Delete comments by all or a specific author in a word processing document
- href: how-to-delete-comments-by-all-or-a-specific-author-in-a-word-processing-document.md
- - name: Extract styles from a word processing document
- href: how-to-extract-styles-from-a-word-processing-document.md
- - name: Insert a comment into a word processing document
- href: how-to-insert-a-comment-into-a-word-processing-document.md
- - name: Insert a picture into a word processing document
- href: how-to-insert-a-picture-into-a-word-processing-document.md
- - name: Insert a table into a word processing document
- href: how-to-insert-a-table-into-a-word-processing-document.md
- - name: Open and add text to a word processing document
- href: how-to-open-and-add-text-to-a-word-processing-document.md
- - name: Open a word processing document for read-only access
- href: how-to-open-a-word-processing-document-for-read-only-access.md
- - name: Open a word processing document from a stream
- href: how-to-open-a-word-processing-document-from-a-stream.md
- - name: Remove hidden text from a word processing document
- href: how-to-remove-hidden-text-from-a-word-processing-document.md
- - name: Remove the headers and footers from a word processing document
- href: how-to-remove-the-headers-and-footers-from-a-word-processing-document.md
- - name: Replace the header in a word processing document
- href: how-to-replace-the-header-in-a-word-processing-document.md
- - name: Replace the styles parts in a word processing document
- href: how-to-replace-the-styles-parts-in-a-word-processing-document.md
- - name: Retrieve application property values from a word processing document
- href: how-to-retrieve-application-property-values-from-a-word-processing-document.md
- - name: Retrieve comments from a word processing document
- href: how-to-retrieve-comments-from-a-word-processing-document.md
- - name: Set a custom property in a word processing document
- href: how-to-set-a-custom-property-in-a-word-processing-document.md
- - name: Set the font for a text run
- href: how-to-set-the-font-for-a-text-run.md
- - name: Validate a word processing document
- href: how-to-validate-a-word-processing-document.md
+ href: presentation/overview.md
+ - name: Add a comment to a slide in a presentation
+ href: presentation/how-to-add-a-comment-to-a-slide-in-a-presentation.md
+ - name: Apply a theme to a presentation
+ href: presentation/how-to-apply-a-theme-to-a-presentation.md
+ - name: Change the fill color of a shape in a presentation
+ href: presentation/how-to-change-the-fill-color-of-a-shape-in-a-presentation.md
+ - name: Create a presentation document by providing a file name
+ href: presentation/how-to-create-a-presentation-document-by-providing-a-file-name.md
+ - name: Delete all the comments by an author from all the slides in a presentation
+ href: presentation/how-to-delete-all-the-comments-by-an-author-from-all-the-slides-in-a-presentatio.md
+ - name: Delete a slide from a presentation
+ href: presentation/how-to-delete-a-slide-from-a-presentation.md
+ - name: Get all the external hyperlinks in a presentation
+ href: presentation/how-to-get-all-the-external-hyperlinks-in-a-presentation.md
+ - name: Get all the text in a slide in a presentation
+ href: presentation/how-to-get-all-the-text-in-a-slide-in-a-presentation.md
+ - name: Get all the text in all slides in a presentation
+ href: presentation/how-to-get-all-the-text-in-all-slides-in-a-presentation.md
+ - name: Get the titles of all the slides in a presentation
+ href: presentation/how-to-get-the-titles-of-all-the-slides-in-a-presentation.md
+ - name: Insert a new slide into a presentation
+ href: presentation/how-to-insert-a-new-slide-into-a-presentation.md
+ - name: Move a slide to a new position in a presentation
+ href: presentation/how-to-move-a-slide-to-a-new-position-in-a-presentation.md
+ - name: Move a paragraph from one presentation to another
+ href: presentation/how-to-move-a-paragraph-from-one-presentation-to-another.md
+ - name: Open a presentation document for read-only access
+ href: presentation/how-to-open-a-presentation-document-for-read-only-access.md
+ - name: Retrieve the number of slides in a presentation document
+ href: presentation/how-to-retrieve-the-number-of-slides-in-a-presentation-document.md
+ - name: Structure of a PresentationML document
+ href: presentation/structure-of-a-presentationml-document.md
+ - name: Working with animation
+ href: presentation/working-with-animation.md
+ - name: Working with comments
+ href: presentation/working-with-comments.md
+ - name: Working with handout master slides
+ href: presentation/working-with-handout-master-slides.md
+ - name: Working with notes slides
+ href: presentation/working-with-notes-slides.md
+ - name: Working with presentations
+ href: presentation/working-with-presentations.md
+ - name: Working with presentation slides
+ href: presentation/working-with-presentation-slides.md
+ - name: Working with slide layouts
+ href: presentation/working-with-slide-layouts.md
+ - name: Working with slide masters
+ href: presentation/working-with-slide-masters.md
+ - name: Spreadsheets
+ items:
+ - name: Overview
+ href: spreadsheet/overview.md
+ - name: Structure of a SpreadsheetML document
+ href: spreadsheet/structure-of-a-spreadsheetml-document.md
+ - name: Add custom UI to a spreadsheet document
+ href: spreadsheet/how-to-add-custom-ui-to-a-spreadsheet-document.md
+ - name: Calculate the sum of a range of cells in a spreadsheet document
+ href: spreadsheet/how-to-calculate-the-sum-of-a-range-of-cells-in-a-spreadsheet-document.md
+ - name: Create a spreadsheet document by providing a file name
+ href: spreadsheet/how-to-create-a-spreadsheet-document-by-providing-a-file-name.md
+ - name: Delete text from a cell in a spreadsheet
+ href: spreadsheet/how-to-delete-text-from-a-cell-in-a-spreadsheet.md
+ - name: Get a column heading in a spreadsheet
+ href: spreadsheet/how-to-get-a-column-heading-in-a-spreadsheet.md
+ - name: Get worksheet information from a package
+ href: spreadsheet/how-to-get-worksheet-information-from-a-package.md
+ - name: Insert a chart into a spreadsheet
+ href: spreadsheet/how-to-insert-a-chart-into-a-spreadsheet.md
+ - name: Insert a new worksheet into a spreadsheet
+ href: spreadsheet/how-to-insert-a-new-worksheet-into-a-spreadsheet.md
+ - name: Insert text into a cell in a spreadsheet
+ href: spreadsheet/how-to-insert-text-into-a-cell-in-a-spreadsheet.md
+ - name: Merge two adjacent cells in a spreadsheet
+ href: spreadsheet/how-to-merge-two-adjacent-cells-in-a-spreadsheet.md
+ - name: Open a spreadsheet document for read-only access
+ href: spreadsheet/how-to-open-a-spreadsheet-document-for-read-only-access.md
+ - name: Open a spreadsheet document from a stream
+ href: spreadsheet/how-to-open-a-spreadsheet-document-from-a-stream.md
+ - name: Parse and read a large spreadsheet
+ href: spreadsheet/how-to-parse-and-read-a-large-spreadsheet.md
+ - name: Retrieve a dictionary of all named ranges in a spreadsheet
+ href: spreadsheet/how-to-retrieve-a-dictionary-of-all-named-ranges-in-a-spreadsheet.md
+ - name: Retrieve a list of the hidden rows or columns in a spreadsheet
+ href: spreadsheet/how-to-retrieve-a-list-of-the-hidden-rows-or-columns-in-a-spreadsheet.md
+ - name: Retrieve a list of the hidden worksheets in a spreadsheet
+ href: spreadsheet/how-to-retrieve-a-list-of-the-hidden-worksheets-in-a-spreadsheet.md
+ - name: Retrieve the values of cells in a spreadsheet
+ href: spreadsheet/how-to-retrieve-the-values-of-cells-in-a-spreadsheet.md
+ - name: Retrieve a list of the worksheets in a spreadsheet
+ href: spreadsheet/how-to-retrieve-a-list-of-the-worksheets-in-a-spreadsheet.md
+ - name: Working with the calculation chain
+ href: spreadsheet/working-with-the-calculation-chain.md
+ - name: Working with conditional formatting
+ href: spreadsheet/working-with-conditional-formatting.md
+ - name: Working with formulas
+ href: spreadsheet/working-with-formulas.md
+ - name: Working with PivotTables
+ href: spreadsheet/working-with-pivottables.md
+ - name: Working with the shared string table
+ href: spreadsheet/working-with-the-shared-string-table.md
+ - name: Working with sheets
+ href: spreadsheet/working-with-sheets.md
+ - name: Working with tables
+ href: spreadsheet/working-with-tables.md
+ - name: Word processing
+ items:
+ - name: Overview
+ href: word/overview.md
+ - name: Structure of a WordprocessingML document
+ href: word/structure-of-a-wordprocessingml-document.md
+ - name: Accept all revisions in a word processing document
+ href: word/how-to-accept-all-revisions-in-a-word-processing-document.md
+ - name: Add tables to word processing documents
+ href: word/how-to-add-tables-to-word-processing-documents.md
+ - name: Apply a style to a paragraph in a word processing document
+ href: word/how-to-apply-a-style-to-a-paragraph-in-a-word-processing-document.md
+ - name: Change the print orientation of a word processing document
+ href: word/how-to-change-the-print-orientation-of-a-word-processing-document.md
+ - name: Change text in a table in a word processing document
+ href: word/how-to-change-text-in-a-table-in-a-word-processing-document.md
+ - name: Convert a word processing document from the DOCM to the DOCX file format
+ href: word/how-to-convert-a-word-processing-document-from-the-docm-to-the-docx-file-format.md
+ - name: Create and add a character style to a word processing document
+ href: word/how-to-create-and-add-a-character-style-to-a-word-processing-document.md
+ - name: Create and add a paragraph style to a word processing document
+ href: word/how-to-create-and-add-a-paragraph-style-to-a-word-processing-document.md
+ - name: Create a word processing document by providing a file name
+ href: word/how-to-create-a-word-processing-document-by-providing-a-file-name.md
+ - name: Delete comments by all or a specific author in a word processing document
+ href: word/how-to-delete-comments-by-all-or-a-specific-author-in-a-word-processing-document.md
+ - name: Extract styles from a word processing document
+ href: word/how-to-extract-styles-from-a-word-processing-document.md
+ - name: Insert a comment into a word processing document
+ href: word/how-to-insert-a-comment-into-a-word-processing-document.md
+ - name: Insert a picture into a word processing document
+ href: word/how-to-insert-a-picture-into-a-word-processing-document.md
+ - name: Insert a table into a word processing document
+ href: word/how-to-insert-a-table-into-a-word-processing-document.md
+ - name: Open and add text to a word processing document
+ href: word/how-to-open-and-add-text-to-a-word-processing-document.md
+ - name: Open a word processing document for read-only access
+ href: word/how-to-open-a-word-processing-document-for-read-only-access.md
+ - name: Open a word processing document from a stream
+ href: word/how-to-open-a-word-processing-document-from-a-stream.md
+ - name: Remove hidden text from a word processing document
+ href: word/how-to-remove-hidden-text-from-a-word-processing-document.md
+ - name: Remove the headers and footers from a word processing document
+ href: word/how-to-remove-the-headers-and-footers-from-a-word-processing-document.md
+ - name: Replace the header in a word processing document
+ href: word/how-to-replace-the-header-in-a-word-processing-document.md
+ - name: Replace the styles parts in a word processing document
+ href: word/how-to-replace-the-styles-parts-in-a-word-processing-document.md
+ - name: Retrieve application property values from a word processing document
+ href: word/how-to-retrieve-application-property-values-from-a-word-processing-document.md
+ - name: Retrieve comments from a word processing document
+ href: word/how-to-retrieve-comments-from-a-word-processing-document.md
+ - name: Set a custom property in a word processing document
+ href: word/how-to-set-a-custom-property-in-a-word-processing-document.md
+ - name: Set the font for a text run
+ href: word/how-to-set-the-font-for-a-text-run.md
+ - name: Validate a word processing document
+ href: word/how-to-validate-a-word-processing-document.md
+ - name: Working with paragraphs
+ href: word/working-with-paragraphs.md
+ - name: Working with runs
+ href: word/working-with-runs.md
+ - name: Working with WordprocessingML tables
+ href: word/working-with-wordprocessingml-tables.md
diff --git a/docs/understanding-the-open-xml-file-formats.md b/docs/understanding-the-open-xml-file-formats.md
deleted file mode 100644
index 5d0facbf..00000000
--- a/docs/understanding-the-open-xml-file-formats.md
+++ /dev/null
@@ -1,36 +0,0 @@
----
-
-api_name:
-- Microsoft.Office.DocumentFormat.OpenXML.Packaging
-api_type:
-- schema
-ms.assetid: ada81388-9ed2-43f4-ab2c-2bb82f711e90
-title: Understanding the Open XML file formats
-ms.suite: office
-
-ms.author: o365devx
-author: o365devx
-ms.topic: conceptual
-ms.date: 11/01/2017
-ms.localizationpriority: high
----
-# Understanding the Open XML file formats
-
-This section provides conceptual topics for understanding and working
-the Open XML file formats and markup languages.
-
-
---------------------------------------------------------------------------------
-## In this section
-[Introduction to markup compatibility (Open XML SDK)](introduction-to-markup-compatibility.md)
-
-[Working with PresentationML documents (Open XML SDK)](working-with-presentationml-documents.md)
-
-[Working with SpreadsheetML documents (Open XML SDK)](working-with-spreadsheetml-documents.md)
-
-[Working with WordprocessingML documents (Open XML SDK)](working-with-wordprocessingml-documents.md)
-
-
---------------------------------------------------------------------------------
-## Related sections
-[How do I... (Open XML SDK)](how-do-i.md)
diff --git a/docs/how-to-accept-all-revisions-in-a-word-processing-document.md b/docs/word/how-to-accept-all-revisions-in-a-word-processing-document.md
similarity index 93%
rename from docs/how-to-accept-all-revisions-in-a-word-processing-document.md
rename to docs/word/how-to-accept-all-revisions-in-a-word-processing-document.md
index 9c5e7e2f..a96fd213 100644
--- a/docs/how-to-accept-all-revisions-in-a-word-processing-document.md
+++ b/docs/word/how-to-accept-all-revisions-in-a-word-processing-document.md
@@ -18,7 +18,7 @@ ms.localizationpriority: high
This topic shows how to use the Open XML SDK for Office to accept all revisions in a word processing document programmatically.
-[!include[Structure](./includes/word/structure.md)]
+[!include[Structure](../includes/word/structure.md)]
The basic document structure of a **WordProcessingML** document consists of the **document** and **body** elements, followed by one or more block level elements such as **p**, which represents a paragraph. A paragraph contains one or more **r** elements. The **r** stands for run, which is a region of text with a common set of properties, such as formatting. A run contains one or more **t** elements. The **t** element contains a range of text. The following code example shows the **WordprocessingML** markup for a document that contains the text "Example text."
@@ -86,9 +86,9 @@ This element specifies that the paragraph mark delimiting the end of a paragraph
Consider a document consisting of two paragraphs (with each paragraph delimited by a pilcrow ΒΆ):
- If the physical character delimiting the end of the first paragraph is deleted and this change is tracked as a revision, the following will result:
+ If the physical character delimiting the end of the first paragraph is deleted and this change is tracked as a revision, the following will result:
-
+
This revision is represented using the following WordprocessingML:
```xml
@@ -176,10 +176,10 @@ After you have run the program, open the word processing file to make
sure that all revision marks have been accepted.
### [CSharp](#tab/cs)
-[!code-csharp[](../samples/word/accept_all_revisions/cs/Program.cs)]
+[!code-csharp[](../../samples/word/accept_all_revisions/cs/Program.cs)]
### [Visual Basic](#tab/vb)
-[!code-vb[](../samples/word/accept_all_revisions/vb/Program.vb)]
+[!code-vb[](../../samples/word/accept_all_revisions/vb/Program.vb)]
## See also
diff --git a/docs/how-to-add-tables-to-word-processing-documents.md b/docs/word/how-to-add-tables-to-word-processing-documents.md
similarity index 99%
rename from docs/how-to-add-tables-to-word-processing-documents.md
rename to docs/word/how-to-add-tables-to-word-processing-documents.md
index 94153914..5a551296 100644
--- a/docs/how-to-add-tables-to-word-processing-documents.md
+++ b/docs/word/how-to-add-tables-to-word-processing-documents.md
@@ -258,10 +258,10 @@ The following code concludes by appending the table to the body of the document,
The following is the complete **AddTable** code sample in C\# and Visual Basic.
### [C#](#tab/cs)
-[!code-csharp[](../samples/word/add_tables/cs/Program.cs)]
+[!code-csharp[](../../samples/word/add_tables/cs/Program.cs)]
### [Visual Basic](#tab/vb)
-[!code-vb[](../samples/word/add_tables/vb/Program.vb)]
+[!code-vb[](../../samples/word/add_tables/vb/Program.vb)]
## See also
diff --git a/docs/how-to-apply-a-style-to-a-paragraph-in-a-word-processing-document.md b/docs/word/how-to-apply-a-style-to-a-paragraph-in-a-word-processing-document.md
similarity index 99%
rename from docs/how-to-apply-a-style-to-a-paragraph-in-a-word-processing-document.md
rename to docs/word/how-to-apply-a-style-to-a-paragraph-in-a-word-processing-document.md
index 9f554331..363f8183 100644
--- a/docs/how-to-apply-a-style-to-a-paragraph-in-a-word-processing-document.md
+++ b/docs/word/how-to-apply-a-style-to-a-paragraph-in-a-word-processing-document.md
@@ -73,7 +73,7 @@ To create the class instance, call one of the overloads of the [Open()](https://
End Using
```
-[!include[Structure](./includes/word/structure.md)]
+[!include[Structure](../includes/word/structure.md)]
## Get the paragraph to style
diff --git a/docs/how-to-change-text-in-a-table-in-a-word-processing-document.md b/docs/word/how-to-change-text-in-a-table-in-a-word-processing-document.md
similarity index 98%
rename from docs/how-to-change-text-in-a-table-in-a-word-processing-document.md
rename to docs/word/how-to-change-text-in-a-table-in-a-word-processing-document.md
index 5d82026a..e67a6e0f 100644
--- a/docs/how-to-change-text-in-a-table-in-a-word-processing-document.md
+++ b/docs/word/how-to-change-text-in-a-table-in-a-word-processing-document.md
@@ -186,10 +186,10 @@ example."
Following is the complete code example.
### [C#](#tab/cs)
-[!code-csharp[](../samples/word/change_text_a_table/cs/Program.cs)]
+[!code-csharp[](../../samples/word/change_text_a_table/cs/Program.cs)]
### [Visual Basic](#tab/vb)
-[!code-vb[](../samples/word/change_text_a_table/vb/Program.vb)]
+[!code-vb[](../../samples/word/change_text_a_table/vb/Program.vb)]
## See also
diff --git a/docs/how-to-change-the-print-orientation-of-a-word-processing-document.md b/docs/word/how-to-change-the-print-orientation-of-a-word-processing-document.md
similarity index 98%
rename from docs/how-to-change-the-print-orientation-of-a-word-processing-document.md
rename to docs/word/how-to-change-the-print-orientation-of-a-word-processing-document.md
index d49000ad..da4e274b 100644
--- a/docs/how-to-change-the-print-orientation-of-a-word-processing-document.md
+++ b/docs/word/how-to-change-the-print-orientation-of-a-word-processing-document.md
@@ -335,10 +335,10 @@ The following is the complete **SetPrintOrientation** code sample in C\# and Vis
Basic.
### [C#](#tab/cs)
-[!code-csharp[](../samples/word/change_the_print_orientation/cs/Program.cs)]
+[!code-csharp[](../../samples/word/change_the_print_orientation/cs/Program.cs)]
### [Visual Basic](#tab/vb)
-[!code-vb[](../samples/word/change_the_print_orientation/vb/Program.vb)]
+[!code-vb[](../../samples/word/change_the_print_orientation/vb/Program.vb)]
-----------------------------------------------------------------------------
diff --git a/docs/how-to-convert-a-word-processing-document-from-the-docm-to-the-docx-file-format.md b/docs/word/how-to-convert-a-word-processing-document-from-the-docm-to-the-docx-file-format.md
similarity index 96%
rename from docs/how-to-convert-a-word-processing-document-from-the-docm-to-the-docx-file-format.md
rename to docs/word/how-to-convert-a-word-processing-document-from-the-docm-to-the-docx-file-format.md
index a74d6193..9af40913 100644
--- a/docs/how-to-convert-a-word-processing-document-from-the-docm-to-the-docx-file-format.md
+++ b/docs/word/how-to-convert-a-word-processing-document-from-the-docm-to-the-docx-file-format.md
@@ -103,7 +103,7 @@ vbaProject part is highlighted.
Figure 1. The vbaProject part
- 
+ 
The task of converting a macro enabled document to one that is not macro
enabled therefore consists largely of removing the vbaProject part from
the document package.
@@ -235,10 +235,10 @@ The following is the complete **ConvertDOCMtoDOCX** code sample in C\# and Visua
Basic.
### [C#](#tab/cs)
-[!code-csharp[](../samples/word/convert_from_the_docm_to_the_docx_file_format/cs/Program.cs)]
+[!code-csharp[](../../samples/word/convert_from_the_docm_to_the_docx_file_format/cs/Program.cs)]
### [Visual Basic](#tab/vb)
-[!code-vb[](../samples/word/convert_from_the_docm_to_the_docx_file_format/vb/Program.vb)]
+[!code-vb[](../../samples/word/convert_from_the_docm_to_the_docx_file_format/vb/Program.vb)]
## See also
diff --git a/docs/how-to-create-a-word-processing-document-by-providing-a-file-name.md b/docs/word/how-to-create-a-word-processing-document-by-providing-a-file-name.md
similarity index 99%
rename from docs/how-to-create-a-word-processing-document-by-providing-a-file-name.md
rename to docs/word/how-to-create-a-word-processing-document-by-providing-a-file-name.md
index de61d962..4689455e 100644
--- a/docs/how-to-create-a-word-processing-document-by-providing-a-file-name.md
+++ b/docs/word/how-to-create-a-word-processing-document-by-providing-a-file-name.md
@@ -96,7 +96,7 @@ you can set about adding the document structure and text.
--------------------------------------------------------------------------------
-[!include[Structure](./includes/word/structure.md)]
+[!include[Structure](../includes/word/structure.md)]
--------------------------------------------------------------------------------
## Generating the WordprocessingML Markup
diff --git a/docs/how-to-create-and-add-a-character-style-to-a-word-processing-document.md b/docs/word/how-to-create-and-add-a-character-style-to-a-word-processing-document.md
similarity index 98%
rename from docs/how-to-create-and-add-a-character-style-to-a-word-processing-document.md
rename to docs/word/how-to-create-and-add-a-character-style-to-a-word-processing-document.md
index 8bfe1553..619aad19 100644
--- a/docs/how-to-create-and-add-a-character-style-to-a-word-processing-document.md
+++ b/docs/word/how-to-create-and-add-a-character-style-to-a-word-processing-document.md
@@ -304,7 +304,7 @@ range of text.
Figure 1. Text with a character style applied
-
+
## How the Code Works
@@ -508,10 +508,10 @@ properties' **rStyle** element.
The following is the complete **CreateAndAddCharacterStyle** code sample in both C\# and Visual Basic.
### [C#](#tab/cs)
-[!code-csharp[](../samples/word/create_and_add_a_character_style/cs/Program.cs)]
+[!code-csharp[](../../samples/word/create_and_add_a_character_style/cs/Program.cs)]
### [Visual Basic](#tab/vb)
-[!code-vb[](../samples/word/create_and_add_a_character_style/vb/Program.vb)]
+[!code-vb[](../../samples/word/create_and_add_a_character_style/vb/Program.vb)]
## See also
diff --git a/docs/how-to-create-and-add-a-paragraph-style-to-a-word-processing-document.md b/docs/word/how-to-create-and-add-a-paragraph-style-to-a-word-processing-document.md
similarity index 99%
rename from docs/how-to-create-and-add-a-paragraph-style-to-a-word-processing-document.md
rename to docs/word/how-to-create-and-add-a-paragraph-style-to-a-word-processing-document.md
index 0619f2f7..5e58a095 100644
--- a/docs/how-to-create-and-add-a-paragraph-style-to-a-word-processing-document.md
+++ b/docs/word/how-to-create-and-add-a-paragraph-style-to-a-word-processing-document.md
@@ -562,10 +562,10 @@ The following is the complete **CreateAndAddParagraphStyle** code sample in both
C\# and Visual Basic.
### [C#](#tab/cs)
-[!code-csharp[](../samples/word/create_and_add_a_paragraph_style/cs/Program.cs)]
+[!code-csharp[](../../samples/word/create_and_add_a_paragraph_style/cs/Program.cs)]
### [Visual Basic](#tab/vb)
-[!code-vb[](../samples/word/create_and_add_a_paragraph_style/vb/Program.vb)]
+[!code-vb[](../../samples/word/create_and_add_a_paragraph_style/vb/Program.vb)]
---------------------------------------------------------------------------------
diff --git a/docs/how-to-delete-comments-by-all-or-a-specific-author-in-a-word-processing-document.md b/docs/word/how-to-delete-comments-by-all-or-a-specific-author-in-a-word-processing-document.md
similarity index 98%
rename from docs/how-to-delete-comments-by-all-or-a-specific-author-in-a-word-processing-document.md
rename to docs/word/how-to-delete-comments-by-all-or-a-specific-author-in-a-word-processing-document.md
index ed5e8913..4937e9e9 100644
--- a/docs/how-to-delete-comments-by-all-or-a-specific-author-in-a-word-processing-document.md
+++ b/docs/word/how-to-delete-comments-by-all-or-a-specific-author-in-a-word-processing-document.md
@@ -327,10 +327,10 @@ saving the document.
The following is the complete code sample in both C\# and Visual Basic.
### [C#](#tab/cs)
-[!code-csharp[](../samples/word/delete_comments_by_all_or_a_specific_author/cs/Program.cs)]
+[!code-csharp[](../../samples/word/delete_comments_by_all_or_a_specific_author/cs/Program.cs)]
### [Visual Basic](#tab/vb)
-[!code-vb[](../samples/word/delete_comments_by_all_or_a_specific_author/vb/Program.vb)]
+[!code-vb[](../../samples/word/delete_comments_by_all_or_a_specific_author/vb/Program.vb)]
--------------------------------------------------------------------------------
diff --git a/docs/how-to-extract-styles-from-a-word-processing-document.md b/docs/word/how-to-extract-styles-from-a-word-processing-document.md
similarity index 98%
rename from docs/how-to-extract-styles-from-a-word-processing-document.md
rename to docs/word/how-to-extract-styles-from-a-word-processing-document.md
index a076b9b0..991eeaff 100644
--- a/docs/how-to-extract-styles-from-a-word-processing-document.md
+++ b/docs/word/how-to-extract-styles-from-a-word-processing-document.md
@@ -255,10 +255,10 @@ parameter.
The following is the complete **ExtractStylesPart** code sample in C\# and Visual Basic.
### [C#](#tab/cs)
-[!code-csharp[](../samples/word/extract_styles/cs/Program.cs)]
+[!code-csharp[](../../samples/word/extract_styles/cs/Program.cs)]
### [Visual Basic](#tab/vb)
-[!code-vb[](../samples/word/extract_styles/vb/Program.vb)]
+[!code-vb[](../../samples/word/extract_styles/vb/Program.vb)]
---------------------------------------------------------------------------------
diff --git a/docs/how-to-insert-a-comment-into-a-word-processing-document.md b/docs/word/how-to-insert-a-comment-into-a-word-processing-document.md
similarity index 98%
rename from docs/how-to-insert-a-comment-into-a-word-processing-document.md
rename to docs/word/how-to-insert-a-comment-into-a-word-processing-document.md
index 8311240b..b5218a5a 100644
--- a/docs/how-to-insert-a-comment-into-a-word-processing-document.md
+++ b/docs/word/how-to-insert-a-comment-into-a-word-processing-document.md
@@ -239,10 +239,10 @@ comment "This is my comment." in the file "Word8.docx."
Following is the complete sample code in both C\# and Visual Basic.
### [C#](#tab/cs)
-[!code-csharp[](../samples/word/insert_a_comment/cs/Program.cs)]
+[!code-csharp[](../../samples/word/insert_a_comment/cs/Program.cs)]
### [Visual Basic](#tab/vb)
-[!code-vb[](../samples/word/insert_a_comment/vb/Program.vb)]
+[!code-vb[](../../samples/word/insert_a_comment/vb/Program.vb)]
--------------------------------------------------------------------------------
## See also
diff --git a/docs/how-to-insert-a-picture-into-a-word-processing-document.md b/docs/word/how-to-insert-a-picture-into-a-word-processing-document.md
similarity index 98%
rename from docs/how-to-insert-a-picture-into-a-word-processing-document.md
rename to docs/word/how-to-insert-a-picture-into-a-word-processing-document.md
index d8eeadd4..f08c225f 100644
--- a/docs/how-to-insert-a-picture-into-a-word-processing-document.md
+++ b/docs/word/how-to-insert-a-picture-into-a-word-processing-document.md
@@ -256,10 +256,10 @@ inserted picture.
The following is the complete sample code in both C\# and Visual Basic.
### [C#](#tab/cs)
-[!code-csharp[](../samples/word/insert_a_picture/cs/Program.cs)]
+[!code-csharp[](../../samples/word/insert_a_picture/cs/Program.cs)]
### [Visual Basic](#tab/vb)
-[!code-vb[](../samples/word/insert_a_picture/vb/Program.vb)]
+[!code-vb[](../../samples/word/insert_a_picture/vb/Program.vb)]
--------------------------------------------------------------------------------
diff --git a/docs/how-to-insert-a-table-into-a-word-processing-document.md b/docs/word/how-to-insert-a-table-into-a-word-processing-document.md
similarity index 98%
rename from docs/how-to-insert-a-table-into-a-word-processing-document.md
rename to docs/word/how-to-insert-a-table-into-a-word-processing-document.md
index 938fafc5..3c29d9a7 100644
--- a/docs/how-to-insert-a-table-into-a-word-processing-document.md
+++ b/docs/word/how-to-insert-a-table-into-a-word-processing-document.md
@@ -267,10 +267,10 @@ inserted table.
Following is the complete sample code in both C\# and Visual Basic.
### [C#](#tab/cs)
-[!code-csharp[](../samples/word/insert_a_table/cs/Program.cs)]
+[!code-csharp[](../../samples/word/insert_a_table/cs/Program.cs)]
### [Visual Basic](#tab/vb)
-[!code-vb[](../samples/word/insert_a_table/vb/Program.vb)]
+[!code-vb[](../../samples/word/insert_a_table/vb/Program.vb)]
## See also
diff --git a/docs/how-to-open-a-word-processing-document-for-read-only-access.md b/docs/word/how-to-open-a-word-processing-document-for-read-only-access.md
similarity index 99%
rename from docs/how-to-open-a-word-processing-document-for-read-only-access.md
rename to docs/word/how-to-open-a-word-processing-document-for-read-only-access.md
index a2d25112..d2af779b 100644
--- a/docs/how-to-open-a-word-processing-document-for-read-only-access.md
+++ b/docs/word/how-to-open-a-word-processing-document-for-read-only-access.md
@@ -168,7 +168,7 @@ code example.
---------------------------------------------------------------------------------
-[!include[Structure](./includes/word/structure.md)]
+[!include[Structure](../includes/word/structure.md)]
--------------------------------------------------------------------------------
## Generate the WordprocessingML Markup to Add Text and Attempt to Save
diff --git a/docs/how-to-open-a-word-processing-document-from-a-stream.md b/docs/word/how-to-open-a-word-processing-document-from-a-stream.md
similarity index 99%
rename from docs/how-to-open-a-word-processing-document-from-a-stream.md
rename to docs/word/how-to-open-a-word-processing-document-from-a-stream.md
index 10402ae4..830be08f 100644
--- a/docs/how-to-open-a-word-processing-document-from-a-stream.md
+++ b/docs/word/how-to-open-a-word-processing-document-from-a-stream.md
@@ -84,7 +84,7 @@ method.
WordprocessingDocument.Open(stream, True)
```
-[!include[Structure](./includes/word/structure.md)]
+[!include[Structure](../includes/word/structure.md)]
## How the Sample Code Works
diff --git a/docs/how-to-open-and-add-text-to-a-word-processing-document.md b/docs/word/how-to-open-and-add-text-to-a-word-processing-document.md
similarity index 99%
rename from docs/how-to-open-and-add-text-to-a-word-processing-document.md
rename to docs/word/how-to-open-and-add-text-to-a-word-processing-document.md
index da1d5eef..d8015198 100644
--- a/docs/how-to-open-and-add-text-to-a-word-processing-document.md
+++ b/docs/word/how-to-open-and-add-text-to-a-word-processing-document.md
@@ -92,7 +92,7 @@ code example.
--------------------------------------------------------------------------------
-[!include[Structure](./includes/word/structure.md)]
+[!include[Structure](../includes/word/structure.md)]
--------------------------------------------------------------------------------
## Generate the WordprocessingML Markup to Add the Text
diff --git a/docs/how-to-remove-hidden-text-from-a-word-processing-document.md b/docs/word/how-to-remove-hidden-text-from-a-word-processing-document.md
similarity index 98%
rename from docs/how-to-remove-hidden-text-from-a-word-processing-document.md
rename to docs/word/how-to-remove-hidden-text-from-a-word-processing-document.md
index 0e430f7c..76daa101 100644
--- a/docs/how-to-remove-hidden-text-from-a-word-processing-document.md
+++ b/docs/word/how-to-remove-hidden-text-from-a-word-processing-document.md
@@ -180,10 +180,10 @@ named "Word14.docx."
Following is the complete sample code in both C\# and Visual Basic.
### [C#](#tab/cs)
-[!code-csharp[](../samples/word/remove_hidden_text/cs/Program.cs)]
+[!code-csharp[](../../samples/word/remove_hidden_text/cs/Program.cs)]
### [Visual Basic](#tab/vb)
-[!code-vb[](../samples/word/remove_hidden_text/vb/Program.vb)]
+[!code-vb[](../../samples/word/remove_hidden_text/vb/Program.vb)]
--------------------------------------------------------------------------------
## See also
diff --git a/docs/how-to-remove-the-headers-and-footers-from-a-word-processing-document.md b/docs/word/how-to-remove-the-headers-and-footers-from-a-word-processing-document.md
similarity index 98%
rename from docs/how-to-remove-the-headers-and-footers-from-a-word-processing-document.md
rename to docs/word/how-to-remove-the-headers-and-footers-from-a-word-processing-document.md
index cf40e7ed..b306b843 100644
--- a/docs/how-to-remove-the-headers-and-footers-from-a-word-processing-document.md
+++ b/docs/word/how-to-remove-the-headers-and-footers-from-a-word-processing-document.md
@@ -260,10 +260,10 @@ The following is the complete **RemoveHeadersAndFooters** code sample in C\# and
Visual Basic.
### [C#](#tab/cs)
-[!code-csharp[](../samples/word/remove_the_headers_and_footers/cs/Program.cs)]
+[!code-csharp[](../../samples/word/remove_the_headers_and_footers/cs/Program.cs)]
### [Visual Basic](#tab/vb)
-[!code-vb[](../samples/word/remove_the_headers_and_footers/vb/Program.vb)]
+[!code-vb[](../../samples/word/remove_the_headers_and_footers/vb/Program.vb)]
## See also
diff --git a/docs/how-to-replace-the-header-in-a-word-processing-document.md b/docs/word/how-to-replace-the-header-in-a-word-processing-document.md
similarity index 96%
rename from docs/how-to-replace-the-header-in-a-word-processing-document.md
rename to docs/word/how-to-replace-the-header-in-a-word-processing-document.md
index a81ab085..1a0783f0 100644
--- a/docs/how-to-replace-the-header-in-a-word-processing-document.md
+++ b/docs/word/how-to-replace-the-header-in-a-word-processing-document.md
@@ -93,7 +93,7 @@ rules shall apply.
*Example*: Consider a three page document with different first, odd,
and even page header defined as follows:
-
+
This document defines three headers, each of which has a relationship
from the document part with a unique relationship ID, as shown in the
@@ -151,10 +151,10 @@ segment as an example.
Following is the complete sample code in both C\# and Visual Basic.
### [C#](#tab/cs)
-[!code-csharp[](../samples/word/replace_the_header/cs/Program.cs)]
+[!code-csharp[](../../samples/word/replace_the_header/cs/Program.cs)]
### [Visual Basic](#tab/vb)
-[!code-vb[](../samples/word/replace_the_header/vb/Program.vb)]
+[!code-vb[](../../samples/word/replace_the_header/vb/Program.vb)]
## See also
diff --git a/docs/how-to-replace-the-styles-parts-in-a-word-processing-document.md b/docs/word/how-to-replace-the-styles-parts-in-a-word-processing-document.md
similarity index 98%
rename from docs/how-to-replace-the-styles-parts-in-a-word-processing-document.md
rename to docs/word/how-to-replace-the-styles-parts-in-a-word-processing-document.md
index 9b7995b5..14f4de3c 100644
--- a/docs/how-to-replace-the-styles-parts-in-a-word-processing-document.md
+++ b/docs/word/how-to-replace-the-styles-parts-in-a-word-processing-document.md
@@ -70,7 +70,7 @@ document that contains styles.
Figure 1. Styles parts in a word processing document
-
+
In order to provide for "round-tripping" a document from Word 2013 to
Word 2010 and back, Word 2013 maintains both the original styles part
and the new styles part. (The Office Open XML File Formats specification
@@ -319,10 +319,10 @@ The following is the complete **ReplaceStyles**, **ReplaceStylesPart**, and **Ex
Basic.
### [C#](#tab/cs)
-[!code-csharp[](../samples/word/replace_the_styles_parts/cs/Program.cs)]
+[!code-csharp[](../../samples/word/replace_the_styles_parts/cs/Program.cs)]
### [Visual Basic](#tab/vb)
-[!code-vb[](../samples/word/replace_the_styles_parts/vb/Program.vb)]
+[!code-vb[](../../samples/word/replace_the_styles_parts/vb/Program.vb)]
---------------------------------------------------------------------------------
diff --git a/docs/how-to-retrieve-application-property-values-from-a-word-processing-document.md b/docs/word/how-to-retrieve-application-property-values-from-a-word-processing-document.md
similarity index 95%
rename from docs/how-to-retrieve-application-property-values-from-a-word-processing-document.md
rename to docs/word/how-to-retrieve-application-property-values-from-a-word-processing-document.md
index b99e22c0..94d5fc7a 100644
--- a/docs/how-to-retrieve-application-property-values-from-a-word-processing-document.md
+++ b/docs/word/how-to-retrieve-application-property-values-from-a-word-processing-document.md
@@ -105,10 +105,10 @@ document properties aren't available if you (or the application) haven't specifi
The following is the complete code sample in C\# and Visual Basic.
### [C#](#tab/cs)
-[!code-csharp[](../samples/word/retrieve_application_property_values/cs/Program.cs)]
+[!code-csharp[](../../samples/word/retrieve_application_property_values/cs/Program.cs)]
### [Visual Basic](#tab/vb)
-[!code-vb[](../samples/word/retrieve_application_property_values/vb/Program.vb)]
+[!code-vb[](../../samples/word/retrieve_application_property_values/vb/Program.vb)]
## See also
diff --git a/docs/how-to-retrieve-comments-from-a-word-processing-document.md b/docs/word/how-to-retrieve-comments-from-a-word-processing-document.md
similarity index 96%
rename from docs/how-to-retrieve-comments-from-a-word-processing-document.md
rename to docs/word/how-to-retrieve-comments-from-a-word-processing-document.md
index 7b8ce76a..e7fcc44a 100644
--- a/docs/how-to-retrieve-comments-from-a-word-processing-document.md
+++ b/docs/word/how-to-retrieve-comments-from-a-word-processing-document.md
@@ -111,7 +111,7 @@ introduces the comment element.
>
> Consider a document with text with an annotated comment as follows:
-
+
> This comment is represented by the following WordprocessingML
> fragment.
@@ -183,10 +183,10 @@ example.
The following is the complete sample code in both C\# and Visual Basic.
### [C#](#tab/cs)
-[!code-csharp[](../samples/word/retrieve_comments/cs/Program.cs)]
+[!code-csharp[](../../samples/word/retrieve_comments/cs/Program.cs)]
### [Visual Basic](#tab/vb)
-[!code-vb[](../samples/word/retrieve_comments/vb/Program.vb)]
+[!code-vb[](../../samples/word/retrieve_comments/vb/Program.vb)]
--------------------------------------------------------------------------------
## See also
diff --git a/docs/how-to-set-a-custom-property-in-a-word-processing-document.md b/docs/word/how-to-set-a-custom-property-in-a-word-processing-document.md
similarity index 98%
rename from docs/how-to-set-a-custom-property-in-a-word-processing-document.md
rename to docs/word/how-to-set-a-custom-property-in-a-word-processing-document.md
index d6ed0791..e13c14b8 100644
--- a/docs/how-to-set-a-custom-property-in-a-word-processing-document.md
+++ b/docs/word/how-to-set-a-custom-property-in-a-word-processing-document.md
@@ -80,7 +80,7 @@ contents of the part.
Figure 1. Open XML SDK Productivity Tool for Microsoft Office
- 
+ 
The relevant XML is also extracted and shown here for ease of reading.
@@ -175,7 +175,7 @@ The custom properties will display in the dialog box that appears, as shown in F
Figure 2. Custom Properties in the Advanced Properties dialog box
- 
+ 
## How the Code Works
@@ -472,10 +472,10 @@ Finally, the code returns the stored original property value.
The following is the complete **SetCustomProperty** code sample in C\# and Visual Basic.
### [C#](#tab/cs)
-[!code-csharp[](../samples/word/set_a_custom_property/cs/Program.cs)]
+[!code-csharp[](../../samples/word/set_a_custom_property/cs/Program.cs)]
### [Visual Basic](#tab/vb)
-[!code-vb[](../samples/word/set_a_custom_property/vb/Program.vb)]
+[!code-vb[](../../samples/word/set_a_custom_property/vb/Program.vb)]
## See also
diff --git a/docs/how-to-set-the-font-for-a-text-run.md b/docs/word/how-to-set-the-font-for-a-text-run.md
similarity index 98%
rename from docs/how-to-set-the-font-for-a-text-run.md
rename to docs/word/how-to-set-the-font-for-a-text-run.md
index 68639d29..a6b2a46f 100644
--- a/docs/how-to-set-the-font-for-a-text-run.md
+++ b/docs/word/how-to-set-the-font-for-a-text-run.md
@@ -211,10 +211,10 @@ changed font.
The following is the complete sample code in both C\# and Visual Basic.
### [C#](#tab/cs)
-[!code-csharp[](../samples/word/set_the_font_for_a_text_run/cs/Program.cs)]
+[!code-csharp[](../../samples/word/set_the_font_for_a_text_run/cs/Program.cs)]
### [Visual Basic](#tab/vb)
-[!code-vb[](../samples/word/set_the_font_for_a_text_run/vb/Program.vb)]
+[!code-vb[](../../samples/word/set_the_font_for_a_text_run/vb/Program.vb)]
--------------------------------------------------------------------------------
## See also
diff --git a/docs/how-to-validate-a-word-processing-document.md b/docs/word/how-to-validate-a-word-processing-document.md
similarity index 96%
rename from docs/how-to-validate-a-word-processing-document.md
rename to docs/word/how-to-validate-a-word-processing-document.md
index fd0f2b55..d8a3a05a 100644
--- a/docs/how-to-validate-a-word-processing-document.md
+++ b/docs/word/how-to-validate-a-word-processing-document.md
@@ -69,10 +69,10 @@ following example that validates a file named "Word18.docx.".
Following is the complete sample code in both C\# and Visual Basic.
### [C#](#tab/cs)
-[!code-csharp[](../samples/word/validate/cs/Program.cs)]
+[!code-csharp[](../../samples/word/validate/cs/Program.cs)]
### [Visual Basic](#tab/vb)
-[!code-vb[](../samples/word/validate/vb/Program.vb)]
+[!code-vb[](../../samples/word/validate/vb/Program.vb)]
--------------------------------------------------------------------------------
## See also
diff --git a/docs/word-processing.md b/docs/word/overview.md
similarity index 90%
rename from docs/word-processing.md
rename to docs/word/overview.md
index e50e1ad6..2a23d16c 100644
--- a/docs/word-processing.md
+++ b/docs/word/overview.md
@@ -5,7 +5,7 @@ api_name:
api_type:
- schema
ms.assetid: 4fcb7fbb-0796-4737-8f05-acbcfa9e1a06
-title: Word processing (Open XML SDK)
+title: Word processing
ms.suite: office
ms.author: o365devx
@@ -15,7 +15,7 @@ ms.date: 11/01/2017
ms.localizationpriority: high
---
-# Word processing (Open XML SDK)
+# Word processing
This section provides how-to topics for working with word processing documents using the Open XML SDK for Office.
@@ -73,9 +73,14 @@ This section provides how-to topics for working with word processing documents u
- [Validate a word processing document](how-to-validate-a-word-processing-document.md)
+- [Working with paragraphs](working-with-paragraphs.md)
+- [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
-- [How do I...](how-do-i.md)
-- [Getting started with the Open XML SDK for Office](getting-started.md)
+- [Getting started with the Open XML SDK for Office](../getting-started.md)
diff --git a/docs/structure-of-a-wordprocessingml-document.md b/docs/word/structure-of-a-wordprocessingml-document.md
similarity index 98%
rename from docs/structure-of-a-wordprocessingml-document.md
rename to docs/word/structure-of-a-wordprocessingml-document.md
index dc343a21..426253e5 100644
--- a/docs/structure-of-a-wordprocessingml-document.md
+++ b/docs/word/structure-of-a-wordprocessingml-document.md
@@ -185,4 +185,4 @@ typical document.
Figure 1. Typical document structure
- 
+ 
diff --git a/docs/working-with-paragraphs.md b/docs/word/working-with-paragraphs.md
similarity index 98%
rename from docs/working-with-paragraphs.md
rename to docs/word/working-with-paragraphs.md
index a4b22cf1..699b3246 100644
--- a/docs/working-with-paragraphs.md
+++ b/docs/word/working-with-paragraphs.md
@@ -137,7 +137,7 @@ WordprocessingML document referenced in the code.
## See also
-[About the Open XML SDK for Office](about-the-open-xml-sdk.md)
+[About the Open XML SDK for Office](../about-the-open-xml-sdk.md)
[Working with runs (Open XML SDK)](working-with-runs.md)
diff --git a/docs/working-with-runs.md b/docs/word/working-with-runs.md
similarity index 98%
rename from docs/working-with-runs.md
rename to docs/word/working-with-runs.md
index 57e438c8..a3dc8eeb 100644
--- a/docs/working-with-runs.md
+++ b/docs/word/working-with-runs.md
@@ -142,7 +142,7 @@ WordprocessingML document specified in the preceding code.
## See also
-[About the Open XML SDK for Office](about-the-open-xml-sdk.md)
+[About the Open XML SDK for Office](../about-the-open-xml-sdk.md)
[Working with paragraphs (Open XML SDK)](working-with-paragraphs.md)
diff --git a/docs/working-with-wordprocessingml-tables.md b/docs/word/working-with-wordprocessingml-tables.md
similarity index 99%
rename from docs/working-with-wordprocessingml-tables.md
rename to docs/word/working-with-wordprocessingml-tables.md
index fb73e060..d13401f2 100644
--- a/docs/working-with-wordprocessingml-tables.md
+++ b/docs/word/working-with-wordprocessingml-tables.md
@@ -201,7 +201,7 @@ When this code is run, the following XML is written to the WordprocessingML docu
## See also
-- [About the Open XML SDK for Office](about-the-open-xml-sdk.md)
+- [About the Open XML SDK for Office](../about-the-open-xml-sdk.md)
- [Structure of a WordprocessingML document (Open XML SDK)](structure-of-a-wordprocessingml-document.md)
- [Working with paragraphs (Open XML SDK)](working-with-paragraphs.md)
- [Working with runs (Open XML SDK)](working-with-runs.md)
diff --git a/docs/working-with-presentationml-documents.md b/docs/working-with-presentationml-documents.md
deleted file mode 100644
index 549ca423..00000000
--- a/docs/working-with-presentationml-documents.md
+++ /dev/null
@@ -1,41 +0,0 @@
----
-
-api_name:
-- Microsoft.Office.DocumentFormat.OpenXML.Packaging
-api_type:
-- schema
-ms.assetid: 56aeeed4-24ce-42ba-a236-6fec6785dd93
-title: Working with PresentationML documents (Open XML SDK)
-ms.suite: office
-
-ms.author: o365devx
-author: o365devx
-ms.topic: conceptual
-ms.date: 11/01/2017
-ms.localizationpriority: high
----
-# Working with PresentationML documents (Open XML SDK)
-
-This section provides conceptual topics for working with PresentationML
-documents.
-
-
---------------------------------------------------------------------------------
-## In this section
-[Structure of a PresentationML document (Open XML SDK)](structure-of-a-presentationml-document.md)
-
-[Working with animation (Open XML SDK)](working-with-animation.md)
-
-[Working with comments (Open XML SDK)](working-with-comments.md)
-
-[Working with handout master slides (Open XML SDK)](working-with-handout-master-slides.md)
-
-[Working with notes slides (Open XML SDK)](working-with-notes-slides.md)
-
-[Working with presentations (Open XML SDK)](working-with-presentations.md)
-
-[Working with presentation slides (Open XML SDK)](working-with-presentation-slides.md)
-
-[Working with slide layouts (Open XML SDK)](working-with-slide-layouts.md)
-
-[Working with slide masters (Open XML SDK)](working-with-slide-masters.md)
diff --git a/docs/working-with-spreadsheetml-documents.md b/docs/working-with-spreadsheetml-documents.md
deleted file mode 100644
index 30001240..00000000
--- a/docs/working-with-spreadsheetml-documents.md
+++ /dev/null
@@ -1,39 +0,0 @@
----
-
-api_name:
-- Microsoft.Office.DocumentFormat.OpenXML.Packaging
-api_type:
-- schema
-ms.assetid: c984c74e-2f06-4aba-a64b-2bb928b2929e
-title: Working with SpreadsheetML documents (Open XML SDK)
-ms.suite: office
-
-ms.author: o365devx
-author: o365devx
-ms.topic: conceptual
-ms.date: 11/01/2017
-ms.localizationpriority: high
----
-# Working with SpreadsheetML documents (Open XML SDK)
-
-This section provides conceptual topics for working with SpreadsheetML
-documents.
-
-
-## In this section
-
-[Structure of a SpreadsheetML document (Open XML SDK)](structure-of-a-spreadsheetml-document.md)
-
-[Working with the calculation chain (Open XML SDK)](working-with-the-calculation-chain.md)
-
-[Working with conditional formatting (Open XML SDK)](working-with-conditional-formatting.md)
-
-[Working with formulas (Open XML SDK)](working-with-formulas.md)
-
-[Working with PivotTables (Open XML SDK)](working-with-pivottables.md)
-
-[Working with the shared string table (Open XML SDK)](working-with-the-shared-string-table.md)
-
-[Working with sheets (Open XML SDK)](working-with-sheets.md)
-
-[Working with SpreadsheetML tables (Open XML SDK)](working-with-tables.md)
diff --git a/docs/working-with-wordprocessingml-documents.md b/docs/working-with-wordprocessingml-documents.md
deleted file mode 100644
index 35ed6cb0..00000000
--- a/docs/working-with-wordprocessingml-documents.md
+++ /dev/null
@@ -1,31 +0,0 @@
----
-
-api_name:
-- Microsoft.Office.DocumentFormat.OpenXML.Packaging
-api_type:
-- schema
-ms.assetid: bead244f-b551-477f-a296-41ead7bfcf5c
-title: Working with WordprocessingML documents (Open XML SDK)
-ms.suite: office
-
-ms.author: o365devx
-author: o365devx
-ms.topic: conceptual
-ms.date: 11/01/2017
-ms.localizationpriority: high
----
-# Working with WordprocessingML documents (Open XML SDK)
-
-This section provides conceptual topics for working with
-WordprocessingML documents.
-
-
---------------------------------------------------------------------------------
-## In this section
-[Working with paragraphs (Open XML SDK)](working-with-paragraphs.md)
-
-[Working with runs (Open XML SDK)](working-with-runs.md)
-
-[Working with WordprocessingML tables (Open XML SDK)](working-with-tables.md)
-
-[Structure of a WordprocessingML document (Open XML SDK)](structure-of-a-wordprocessingml-document.md)