Move redir files and cleanup markdown files in root (#11362)

* Move redir files and cleanup markdown files in root

* Update source_path in redirection files

* Update source_path in redirection files

.openpublishing.publish.config.json

@@ -72,14 +72,14 @@
   "need_preview_pull_request": true,
   "notification_subscribers": [],
   "redirection_files": [
-    ".openpublishing.redirection.json",
-    ".openpublishing.redirection.51.json",
-    ".openpublishing.redirection.72.json",
-    ".openpublishing.redirection.dsc.json",
-    ".openpublishing.redirection.gallery.json",
-    ".openpublishing.redirection.psget.json",
-    ".openpublishing.redirection.virtual.json",
-    ".openpublishing.redirection.wmf.json"
+    "redir/.openpublishing.redirection.json",
+    "redir/.openpublishing.redirection.51.json",
+    "redir/.openpublishing.redirection.72.json",
+    "redir/.openpublishing.redirection.dsc.json",
+    "redir/.openpublishing.redirection.gallery.json",
+    "redir/.openpublishing.redirection.psget.json",
+    "redir/.openpublishing.redirection.virtual.json",
+    "redir/.openpublishing.redirection.wmf.json"
   ],
   "skip_source_output_uploading": false,
   "sync_notification_subscribers": [],

LICENSE-CODE.md

@@ -0,0 +1,20 @@
+The MIT License (MIT)
+Copyright (c) Microsoft Corporation
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
+of the Software, and to permit persons to whom the Software is furnished to do
+so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -1,5 +1,5 @@
 ---
-ms.date: 02/13/2024
+ms.date: 08/28/2024
 ---
 # PowerShell Documentation
 
@@ -33,6 +33,7 @@ The following list describes the main folders in this repository.
 - `.vscode` - contains configuration settings and recommended extensions for Visual Studio Code (VS
   Code)
 - `assets` - contains downloadable files linked in the documentation
+- `redir` - contain redirection mapping files
 - `reference` - contains the documentation published to
   [learn.microsoft.com][01]. This includes both
   reference and conceptual content.

SECURITY.md

@@ -2,40 +2,65 @@
 
 ## Security
 
-Microsoft takes the security of our software products and services seriously, which includes all source code repositories managed through our GitHub organizations, which include [Microsoft](https://github.com/microsoft), [Azure](https://github.com/Azure), [DotNet](https://github.com/dotnet), [AspNet](https://github.com/aspnet), [Xamarin](https://github.com/xamarin), and [our GitHub organizations](https://opensource.microsoft.com/).
+Microsoft takes the security of our software products and services seriously, which includes all
+source code repositories managed through our GitHub organizations, which include [Microsoft][10],
+[Azure][08], [DotNet][09], [AspNet][07], [Xamarin][11], and [our GitHub organizations][12].
 
-If you believe you have found a security vulnerability in any Microsoft-owned repository that meets [Microsoft's definition of a security vulnerability](https://aka.ms/opensource/security/definition), please report it to us as described below.
+If you believe you have found a security vulnerability in any Microsoft-owned repository that meets
+[Microsoft's definition of a security vulnerability][04], please report it to us as described below.
 
 ## Reporting Security Issues
 
 **Please do not report security vulnerabilities through public GitHub issues.**
 
-Instead, please report them to the Microsoft Security Response Center (MSRC) at [https://msrc.microsoft.com/create-report](https://aka.ms/opensource/security/create-report).
+Instead, please report them to the Microsoft Security Response Center (MSRC) at
+[https://msrc.microsoft.com/create-report][02].
 
-If you prefer to submit without logging in, send email to [secure@microsoft.com](mailto:secure@microsoft.com).  If possible, encrypt your message with our PGP key; please download it from the [Microsoft Security Response Center PGP Key page](https://aka.ms/opensource/security/pgpkey).
+If you prefer to submit without logging in, send email to [secure@microsoft.com][13]. If possible,
+encrypt your message with our PGP key; please download it from the
+[Microsoft Security Response Center PGP Key page][06].
 
-You should receive a response within 24 hours. If for some reason you do not, please follow up via email to ensure we received your original message. Additional information can be found at [microsoft.com/msrc](https://aka.ms/opensource/security/msrc). 
+You should receive a response within 24 hours. If for some reason you do not, please follow up via
+email to ensure we received your original message. Additional information can be found at
+[microsoft.com/msrc][05].
 
-Please include the requested information listed below (as much as you can provide) to help us better understand the nature and scope of the possible issue:
+Please include the requested information listed below (as much as you can provide) to help us better
+understand the nature and scope of the possible issue:
 
-  * Type of issue (e.g. buffer overflow, SQL injection, cross-site scripting, etc.)
-  * Full paths of source file(s) related to the manifestation of the issue
-  * The location of the affected source code (tag/branch/commit or direct URL)
-  * Any special configuration required to reproduce the issue
-  * Step-by-step instructions to reproduce the issue
-  * Proof-of-concept or exploit code (if possible)
-  * Impact of the issue, including how an attacker might exploit the issue
+- Type of issue (e.g. buffer overflow, SQL injection, cross-site scripting, etc.)
+- Full paths of source file(s) related to the manifestation of the issue
+- The location of the affected source code (tag/branch/commit or direct URL)
+- Any special configuration required to reproduce the issue
+- Step-by-step instructions to reproduce the issue
+- Proof-of-concept or exploit code (if possible)
+- Impact of the issue, including how an attacker might exploit the issue
 
 This information will help us triage your report more quickly.
 
-If you are reporting for a bug bounty, more complete reports can contribute to a higher bounty award. Please visit our [Microsoft Bug Bounty Program](https://aka.ms/opensource/security/bounty) page for more details about our active programs.
+If you are reporting for a bug bounty, more complete reports can contribute to a higher bounty
+award. Please visit our [Microsoft Bug Bounty Program][01] page for more details about our active
+programs.
 
 ## Preferred Languages
 
 We prefer all communications to be in English.
 
 ## Policy
 
-Microsoft follows the principle of [Coordinated Vulnerability Disclosure](https://aka.ms/opensource/security/cvd).
+Microsoft follows the principle of [Coordinated Vulnerability Disclosure][03].
 
 <!-- END MICROSOFT SECURITY.MD BLOCK -->
+<!-- link references -->
+[01]: https://aka.ms/opensource/security/bounty
+[02]: https://aka.ms/opensource/security/create-report
+[03]: https://aka.ms/opensource/security/cvd
+[04]: https://aka.ms/opensource/security/definition
+[05]: https://aka.ms/opensource/security/msrc
+[06]: https://aka.ms/opensource/security/pgpkey
+[07]: https://github.com/aspnet
+[08]: https://github.com/Azure
+[09]: https://github.com/dotnet
+[10]: https://github.com/microsoft
+[11]: https://github.com/xamarin
+[12]: https://opensource.microsoft.com/
+[13]: mailto:secure@microsoft.com

ThirdPartyNotices.md

@@ -0,0 +1,25 @@
+## Legal Notices
+
+Microsoft and any contributors grant you a license to the Microsoft documentation and other content
+in this repository under the [Creative Commons Attribution 4.0 International Public License][01],
+see the [LICENSE][05] file, and grant you a license to any code in the repository under the
+[MIT License][03], see the [LICENSE-CODE][06] file.
+
+Microsoft, Windows, Microsoft Azure and/or other Microsoft products and services referenced in the
+documentation may be either trademarks or registered trademarks of Microsoft in the United States
+and/or other countries. The licenses for this project do not grant you rights to use any Microsoft
+names, logos, or trademarks. Microsoft's general trademark guidelines can be found at
+[https://go.microsoft.com/fwlink/?LinkID=254653][02].
+
+Privacy information can be found at [https://privacy.microsoft.com][04].
+
+Microsoft and any contributors reserve all others rights, whether under their respective copyrights,
+patents, or trademarks, whether by implication, estoppel or otherwise.
+
+<!-- link references -->
+[01]: https://creativecommons.org/licenses/by/4.0/legalcode
+[02]: https://go.microsoft.com/fwlink/?LinkID=254653
+[03]: https://opensource.org/licenses/MIT
+[04]: https://privacy.microsoft.com
+[05]: LICENSE
+[06]: LICENSE-CODE

.openpublishing.redirection.51.json → redir/.openpublishing.redirection.51.json

@@ -3,12 +3,12 @@
     {
       "redirect_document_id": true,
       "redirect_url": "/powershell/module/microsoft.powershell.core/get-verb?view=powershell-5.1",
-      "source_path": "reference/5.1/microsoft.powershell.core/functions/get-verb.md"
+      "source_path": "../reference/5.1/microsoft.powershell.core/functions/get-verb.md"
     },
     {
       "redirect_document_id": false,
       "redirect_url": "/powershell/scripting/learn/remoting/powershell-remoting-faq",
-      "source_path": "reference/5.1/Microsoft.PowerShell.Core/About/about_Remote_FAQ.md"
+      "source_path": "../reference/5.1/Microsoft.PowerShell.Core/About/about_Remote_FAQ.md"
     }
   ]
 }

.openpublishing.redirection.72.json → redir/.openpublishing.redirection.72.json

@@ -3,12 +3,12 @@
     {
       "redirect_document_id": true,
       "redirect_url": "/powershell/module/microsoft.powershell.utility/get-verb?view=powershell-7.2",
-      "source_path": "reference/7.2/microsoft.powershell.utility/get-verb.md"
+      "source_path": "../reference/7.2/microsoft.powershell.utility/get-verb.md"
     },
     {
       "redirect_document_id": false,
       "redirect_url": "/powershell/scripting/learn/remoting/powershell-remoting-faq",
-      "source_path": "reference/7.2/Microsoft.PowerShell.Core/About/about_Remote_FAQ.md"
+      "source_path": "../reference/7.2/Microsoft.PowerShell.Core/About/about_Remote_FAQ.md"
     }
   ]
 }