diff --git a/reference/docfx.json b/reference/docfx.json index 41878104d56f..041d103201a1 100644 --- a/reference/docfx.json +++ b/reference/docfx.json @@ -56,15 +56,17 @@ "7.3/**/*": "managed-reference", "7.4/**/*": "managed-reference", "7.5/**/*": "managed-reference", + "docs-conceptual/community/contributing/**/*.md": "contributor-guide", "docs-conceptual/**/*.md": "conceptual", "docs-conceptual/dev-cross-plat/**/*.md": "reference", "docs-conceptual/developer/**/*.md": "reference", - "docs-conceptual/lang-spec/**/*.md": "reference", + "docs-conceptual/lang-spec/**/*.md": "language-reference", "docs-conceptual/learn/*.md": "tutorial", "docs-conceptual/learn/deep-dives/*.md": "tutorial", "docs-conceptual/learn/ps101/*.md": "conceptual", "docs-conceptual/learn/remoting/*.md": "tutorial", - "docs-conceptual/samples/**/*.md": "sample" + "docs-conceptual/samples/**/*.md": "sample", + "docs-conceptual/whats-new/**/*.md": "whats-new" }, "products": { "5.1/**/*": [ diff --git a/reference/docs-conceptual/community/contributing/editorial-checklist.md b/reference/docs-conceptual/community/contributing/editorial-checklist.md index 74850d1e9e70..acbc011cd460 100644 --- a/reference/docs-conceptual/community/contributing/editorial-checklist.md +++ b/reference/docs-conceptual/community/contributing/editorial-checklist.md @@ -1,7 +1,6 @@ --- description: This is a summarized list of rules for editing PowerShell documentation. ms.date: 11/16/2022 -ms.topic: conceptual title: Editorial checklist --- # Editor's checklist diff --git a/reference/docs-conceptual/community/contributing/file-an-issue.md b/reference/docs-conceptual/community/contributing/file-an-issue.md index be6e070ed312..d54d2c8ed4a7 100644 --- a/reference/docs-conceptual/community/contributing/file-an-issue.md +++ b/reference/docs-conceptual/community/contributing/file-an-issue.md @@ -1,7 +1,6 @@ --- description: This article explains how to give feedback about the PowerShell documentation. ms.date: 07/26/2022 -ms.topic: conceptual title: How to file a PowerShell-Docs issue --- # How to file a PowerShell-Docs issue diff --git a/reference/docs-conceptual/community/contributing/general-markdown.md b/reference/docs-conceptual/community/contributing/general-markdown.md index 8ca682c6e4fe..6d084dfaec74 100644 --- a/reference/docs-conceptual/community/contributing/general-markdown.md +++ b/reference/docs-conceptual/community/contributing/general-markdown.md @@ -1,7 +1,6 @@ --- description: This article provides specific guidance for using Markdown in our documentation. ms.date: 07/26/2022 -ms.topic: conceptual title: Markdown best practices --- # Markdown best practices diff --git a/reference/docs-conceptual/community/contributing/get-started-writing.md b/reference/docs-conceptual/community/contributing/get-started-writing.md index 16e87571a0aa..dd7edecdf668 100644 --- a/reference/docs-conceptual/community/contributing/get-started-writing.md +++ b/reference/docs-conceptual/community/contributing/get-started-writing.md @@ -1,7 +1,6 @@ --- description: This article is an overview of how to get started as a contributor to the PowerShell documentation. ms.date: 07/26/2022 -ms.topic: conceptual title: Get started contributing to PowerShell documentation --- # Get started contributing to PowerShell documentation diff --git a/reference/docs-conceptual/community/contributing/hackathons.md b/reference/docs-conceptual/community/contributing/hackathons.md index 87e4c8adcd94..f099eafbb4c8 100644 --- a/reference/docs-conceptual/community/contributing/hackathons.md +++ b/reference/docs-conceptual/community/contributing/hackathons.md @@ -1,7 +1,6 @@ --- description: This article describes how we manage and support hack-a-thon events like Hacktoberfest. ms.date: 10/04/2022 -ms.topic: conceptual title: Hacktoberfest and other hack-a-thon events --- # Hacktoberfest and other hack-a-thon events diff --git a/reference/docs-conceptual/community/contributing/labelling-in-github.md b/reference/docs-conceptual/community/contributing/labelling-in-github.md index b8d8285d4bdc..f92c2d84c579 100644 --- a/reference/docs-conceptual/community/contributing/labelling-in-github.md +++ b/reference/docs-conceptual/community/contributing/labelling-in-github.md @@ -1,7 +1,6 @@ --- description: This article explains how the PowerShell-Docs team uses labels in GitHub. ms.date: 12/16/2022 -ms.topic: conceptual title: Labelling in GitHub --- diff --git a/reference/docs-conceptual/community/contributing/managing-issues.md b/reference/docs-conceptual/community/contributing/managing-issues.md index d87110aeaa60..9f494199dcb5 100644 --- a/reference/docs-conceptual/community/contributing/managing-issues.md +++ b/reference/docs-conceptual/community/contributing/managing-issues.md @@ -1,7 +1,6 @@ --- description: This article explains how the PowerShell-Docs team manages issues. ms.date: 11/09/2022 -ms.topic: conceptual title: How we manage issues --- # How we manage issues diff --git a/reference/docs-conceptual/community/contributing/managing-pull-requests.md b/reference/docs-conceptual/community/contributing/managing-pull-requests.md index 502ad3873d89..e883da168570 100644 --- a/reference/docs-conceptual/community/contributing/managing-pull-requests.md +++ b/reference/docs-conceptual/community/contributing/managing-pull-requests.md @@ -1,7 +1,6 @@ --- description: This article explains how the PowerShell-Docs team manages pull requests. ms.date: 07/25/2022 -ms.topic: conceptual title: How we manage pull requests --- # Managing pull requests diff --git a/reference/docs-conceptual/community/contributing/overview.md b/reference/docs-conceptual/community/contributing/overview.md index a8cb059ede68..60ae6bdc45ce 100644 --- a/reference/docs-conceptual/community/contributing/overview.md +++ b/reference/docs-conceptual/community/contributing/overview.md @@ -1,7 +1,6 @@ --- description: This article outlines the steps required to contribute to the PowerShell documentation. ms.date: 07/25/2022 -ms.topic: conceptual title: Contributing to PowerShell documentation --- # Contributing to PowerShell documentation diff --git a/reference/docs-conceptual/community/contributing/powershell-style-guide.md b/reference/docs-conceptual/community/contributing/powershell-style-guide.md index 6b6dfb755589..40aaffa87a69 100644 --- a/reference/docs-conceptual/community/contributing/powershell-style-guide.md +++ b/reference/docs-conceptual/community/contributing/powershell-style-guide.md @@ -1,7 +1,6 @@ --- description: This article provides the rules of style for writing PowerShell documentation. ms.date: 11/14/2022 -ms.topic: conceptual title: PowerShell-Docs style guide --- # PowerShell-Docs style guide diff --git a/reference/docs-conceptual/community/contributing/product-terminology.md b/reference/docs-conceptual/community/contributing/product-terminology.md index 9c1e3b5f0a16..0549b9349578 100644 --- a/reference/docs-conceptual/community/contributing/product-terminology.md +++ b/reference/docs-conceptual/community/contributing/product-terminology.md @@ -1,8 +1,6 @@ --- description: This article contains guidelines for the proper use of product names and terms. ms.date: 11/14/2022 -ms.topic: conceptual -ms.custom: has-azure-ad-ps-ref title: Product terminology and branding guidelines --- # Product terminology and branding guidelines diff --git a/reference/docs-conceptual/community/contributing/pull-requests.md b/reference/docs-conceptual/community/contributing/pull-requests.md index 0c844d868bd7..b2abc7b5e413 100644 --- a/reference/docs-conceptual/community/contributing/pull-requests.md +++ b/reference/docs-conceptual/community/contributing/pull-requests.md @@ -1,7 +1,6 @@ --- description: This article explains how to submit pull requests to the PowerShell-Docs repository. ms.date: 07/26/2022 -ms.topic: conceptual title: How to submit pull requests --- # How to submit pull requests diff --git a/reference/docs-conceptual/community/contributing/quality-improvements.md b/reference/docs-conceptual/community/contributing/quality-improvements.md index cd19ba76d337..a025e5560683 100644 --- a/reference/docs-conceptual/community/contributing/quality-improvements.md +++ b/reference/docs-conceptual/community/contributing/quality-improvements.md @@ -2,7 +2,6 @@ description: >- This article describes the process for contributing quality improvements to the documentation. ms.date: 06/28/2023 -ms.topic: conceptual title: Contributing quality improvements --- diff --git a/reference/docs-conceptual/community/contributing/using-github-codespaces.md b/reference/docs-conceptual/community/contributing/using-github-codespaces.md index 6c5c14eeef18..4796bb96fa6e 100644 --- a/reference/docs-conceptual/community/contributing/using-github-codespaces.md +++ b/reference/docs-conceptual/community/contributing/using-github-codespaces.md @@ -3,7 +3,6 @@ description: >- This article describes the process for contributing to the documentation using GitHub Codespaces as an authoring environment. ms.date: 05/10/2023 -ms.topic: conceptual title: Contribute using GitHub Codespaces --- diff --git a/reference/docs-conceptual/developer/cmdlet/strongly-encouraged-development-guidelines.md b/reference/docs-conceptual/developer/cmdlet/strongly-encouraged-development-guidelines.md index e9cc9d2883f7..37f743041e8e 100644 --- a/reference/docs-conceptual/developer/cmdlet/strongly-encouraged-development-guidelines.md +++ b/reference/docs-conceptual/developer/cmdlet/strongly-encouraged-development-guidelines.md @@ -1,7 +1,7 @@ --- description: Strongly Encouraged Development Guidelines ms.date: 10/05/2021 -ms.topic: reference +ms.topic: design-pattern title: Strongly Encouraged Development Guidelines --- # Strongly Encouraged Development Guidelines diff --git a/reference/docs-conceptual/discover-powershell.md b/reference/docs-conceptual/discover-powershell.md index e8da5a7ef609..f33c170728b6 100644 --- a/reference/docs-conceptual/discover-powershell.md +++ b/reference/docs-conceptual/discover-powershell.md @@ -1,7 +1,7 @@ --- description: Learn what PowerShell is and some essential commands used to discover more about PowerShell. ms.date: 01/31/2023 -ms.reviewer: sewhee +ms.topic: overview title: Discover PowerShell --- diff --git a/reference/docs-conceptual/install/PowerShell-Support-Lifecycle.md b/reference/docs-conceptual/install/PowerShell-Support-Lifecycle.md index 79a55771d549..60ce24a04d7e 100644 --- a/reference/docs-conceptual/install/PowerShell-Support-Lifecycle.md +++ b/reference/docs-conceptual/install/PowerShell-Support-Lifecycle.md @@ -1,6 +1,7 @@ --- description: Details the policies governing support for PowerShell ms.date: 02/23/2024 +ms.topic: lifecycle title: PowerShell Support Lifecycle --- # PowerShell Support Lifecycle diff --git a/reference/docs-conceptual/overview.md b/reference/docs-conceptual/overview.md index eacaf8f97fa2..5f85c28f4a82 100644 --- a/reference/docs-conceptual/overview.md +++ b/reference/docs-conceptual/overview.md @@ -1,6 +1,7 @@ --- description: This article is an introduction to the PowerShell scripting environment and its features. ms.date: 06/28/2023 +ms.topic: overview title: What is PowerShell? --- diff --git a/reference/docs-conceptual/powershell-commands.md b/reference/docs-conceptual/powershell-commands.md index aedf82c067a7..4296c14c34f7 100644 --- a/reference/docs-conceptual/powershell-commands.md +++ b/reference/docs-conceptual/powershell-commands.md @@ -1,6 +1,7 @@ --- description: Commands for PowerShell are known as cmdlets (pronounced command-lets) ms.date: 11/16/2022 +ms.topic: overview title: What is a PowerShell command? --- # What is a PowerShell command (cmdlet)? diff --git a/reference/docs-conceptual/windows-powershell/ise/Accessibility-in-Windows-PowerShell-ISE.md b/reference/docs-conceptual/windows-powershell/ise/Accessibility-in-Windows-PowerShell-ISE.md index 47d236cb231d..ed6307b2872e 100644 --- a/reference/docs-conceptual/windows-powershell/ise/Accessibility-in-Windows-PowerShell-ISE.md +++ b/reference/docs-conceptual/windows-powershell/ise/Accessibility-in-Windows-PowerShell-ISE.md @@ -1,6 +1,7 @@ --- description: This topic describes the accessibility features of Windows PowerShell Integrated Scripting Environment (ISE) that you might find helpful. ms.date: 12/19/2019 +ms.topic: ui-reference title: Accessibility in Windows PowerShell ISE --- diff --git a/reference/docs-conceptual/windows-powershell/ise/Exploring-the-Windows-PowerShell-ISE.md b/reference/docs-conceptual/windows-powershell/ise/Exploring-the-Windows-PowerShell-ISE.md index f3f48e2f64aa..341877966f69 100644 --- a/reference/docs-conceptual/windows-powershell/ise/Exploring-the-Windows-PowerShell-ISE.md +++ b/reference/docs-conceptual/windows-powershell/ise/Exploring-the-Windows-PowerShell-ISE.md @@ -2,7 +2,7 @@ description: This article is an overview of the features of the Windows PowerShell ISE ms.custom: ISE-F1-page ms.date: 05/04/2023 -ms.topic: conceptual +ms.topic: ui-reference title: Exploring the Windows PowerShell ISE --- diff --git a/reference/docs-conceptual/windows-powershell/ise/How-to-Create-a-PowerShell-Tab-in-Windows-PowerShell-ISE.md b/reference/docs-conceptual/windows-powershell/ise/How-to-Create-a-PowerShell-Tab-in-Windows-PowerShell-ISE.md index 99162df04d06..c24c64e9ee3d 100644 --- a/reference/docs-conceptual/windows-powershell/ise/How-to-Create-a-PowerShell-Tab-in-Windows-PowerShell-ISE.md +++ b/reference/docs-conceptual/windows-powershell/ise/How-to-Create-a-PowerShell-Tab-in-Windows-PowerShell-ISE.md @@ -1,6 +1,7 @@ --- description: Tabs in the Windows PowerShell Integrated Scripting Environment (ISE) allow you to simultaneously create and use several execution environments within the same application. Each PowerShell tab corresponds to a separate execution environment or session. ms.date: 10/07/2021 +ms.topic: ui-reference title: How to Create a PowerShell Tab in Windows PowerShell ISE --- diff --git a/reference/docs-conceptual/windows-powershell/ise/How-to-Debug-Scripts-in-Windows-PowerShell-ISE.md b/reference/docs-conceptual/windows-powershell/ise/How-to-Debug-Scripts-in-Windows-PowerShell-ISE.md index ba00ee8bafcb..a793e6e084ca 100644 --- a/reference/docs-conceptual/windows-powershell/ise/How-to-Debug-Scripts-in-Windows-PowerShell-ISE.md +++ b/reference/docs-conceptual/windows-powershell/ise/How-to-Debug-Scripts-in-Windows-PowerShell-ISE.md @@ -1,6 +1,7 @@ --- description: This article describes how to debug scripts on a local computer by using the Windows PowerShell ISE visual debugging features. ms.date: 10/07/2021 +ms.topic: ui-reference title: How to Debug Scripts in Windows PowerShell ISE --- diff --git a/reference/docs-conceptual/windows-powershell/ise/How-to-Use-the-Console-Pane-in-the-Windows-PowerShell-ISE.md b/reference/docs-conceptual/windows-powershell/ise/How-to-Use-the-Console-Pane-in-the-Windows-PowerShell-ISE.md index 4b436770d17e..b05869b8f303 100644 --- a/reference/docs-conceptual/windows-powershell/ise/How-to-Use-the-Console-Pane-in-the-Windows-PowerShell-ISE.md +++ b/reference/docs-conceptual/windows-powershell/ise/How-to-Use-the-Console-Pane-in-the-Windows-PowerShell-ISE.md @@ -1,6 +1,7 @@ --- description: How to Use the Console Pane in the Windows PowerShell ISE ms.date: 01/02/2020 +ms.topic: ui-reference title: How to Use the Console Pane in the Windows PowerShell ISE --- diff --git a/reference/docs-conceptual/windows-powershell/ise/Introducing-the-Windows-PowerShell-ISE.md b/reference/docs-conceptual/windows-powershell/ise/Introducing-the-Windows-PowerShell-ISE.md index 6253583733b4..a7da093393e0 100644 --- a/reference/docs-conceptual/windows-powershell/ise/Introducing-the-Windows-PowerShell-ISE.md +++ b/reference/docs-conceptual/windows-powershell/ise/Introducing-the-Windows-PowerShell-ISE.md @@ -1,6 +1,7 @@ --- description: The PowerShell ISE is a host application for Windows PowerShell that allows you to run commands and write, test, and debug scripts in a single Windows-based graphic user interface. ms.date: 10/07/2021 +ms.topic: overview title: Introducing the Windows PowerShell ISE --- diff --git a/reference/docs-conceptual/windows-powershell/ise/Keyboard-Shortcuts-for-the-Windows-PowerShell-ISE.md b/reference/docs-conceptual/windows-powershell/ise/Keyboard-Shortcuts-for-the-Windows-PowerShell-ISE.md index 7b7531eba621..2f9600e55bd9 100644 --- a/reference/docs-conceptual/windows-powershell/ise/Keyboard-Shortcuts-for-the-Windows-PowerShell-ISE.md +++ b/reference/docs-conceptual/windows-powershell/ise/Keyboard-Shortcuts-for-the-Windows-PowerShell-ISE.md @@ -1,6 +1,7 @@ --- description: This article is a list of the keyboard shortcuts used in the PowerShell ISE. ms.date: 03/04/2024 +ms.topic: ui-reference title: Keyboard Shortcuts for the Windows PowerShell ISE --- diff --git a/reference/docs-conceptual/windows-powershell/overview.md b/reference/docs-conceptual/windows-powershell/overview.md index 58bf5342278a..4be157c2506a 100644 --- a/reference/docs-conceptual/windows-powershell/overview.md +++ b/reference/docs-conceptual/windows-powershell/overview.md @@ -1,7 +1,7 @@ --- description: This article explains the difference between Windows PowerShell and PowerShell. ms.date: 11/03/2023 -ms.topic: conceptual +ms.topic: overview title: What is Windows PowerShell? --- # What is Windows PowerShell? diff --git a/reference/docs-conceptual/windows-powershell/wmf-overview.md b/reference/docs-conceptual/windows-powershell/wmf-overview.md index 063e590a2396..4e866776c7bb 100644 --- a/reference/docs-conceptual/windows-powershell/wmf-overview.md +++ b/reference/docs-conceptual/windows-powershell/wmf-overview.md @@ -1,6 +1,7 @@ --- description: WMF is a prerequisite for Windows PowerShell. This articles shows the history of WMF versions and provides information about how to find and install WMF. ms.date: 11/03/2023 +ms.topic: overview title: Windows Management Framework (WMF) ---