diff --git a/.azurepipelines/Ubuntu-GCC5.yml b/.azurepipelines/Ubuntu-GCC5.yml
index 367e4144..2199b6a8 100644
--- a/.azurepipelines/Ubuntu-GCC5.yml
+++ b/.azurepipelines/Ubuntu-GCC5.yml
@@ -1,32 +1,40 @@
-## @file
-# Azure Pipeline build file for a build using Ubuntu and GCC.
-#
-# Copyright (c) Microsoft Corporation.
-# Copyright (c) 2020, Hewlett Packard Enterprise Development LP. All rights reserved.
-# SPDX-License-Identifier: BSD-2-Clause-Patent
-##
-
-resources:
- repositories:
- - repository: mu_devops
- type: github
- endpoint: microsoft
- name: microsoft/mu_devops
- ref: main
-
-variables:
-- group: architectures-arm-64-x86-64
-- group: tool-chain-ubuntu-gcc
-
-jobs:
-- template: Matrix-Build-Job.yml
- parameters:
- arch_list: $(arch_list)
- extra_build_args: CODE_COVERAGE=TRUE CC_HTML=TRUE
- extra_install_step:
- - script: |
- sudo apt-get install -y mingw-w64 lcov
- pip install lcov_cobertura pycobertura
- displayName: Install Windows Resource Compiler for Linux & Code Coverage Tools
- tool_chain_tag: $(tool_chain_tag)
- vm_image: $(vm_image)
+## @file
+# Azure Pipeline build file for a build using Ubuntu and GCC.
+#
+# IMPORTANT: This file requires the local repo to contain a .azurepipelines/Matrix-Build-Job.yml file that
+# performs the actual build steps for the configurations and packages supported by the repo.
+#
+# NOTE: This file is automatically synchronized from Mu DevOps. Update the original file there
+# instead of the file in this repo.
+#
+# - Mu DevOps Repo: https://github.com/microsoft/mu_devops
+# - File Sync Settings: https://github.com/microsoft/mu_devops/blob/main/.sync/Files.yml
+#
+# Copyright (c) Microsoft Corporation.
+# SPDX-License-Identifier: BSD-2-Clause-Patent
+##
+
+resources:
+ repositories:
+ - repository: mu_devops
+ type: github
+ endpoint: microsoft
+ name: microsoft/mu_devops
+ ref: main
+
+variables:
+- group: architectures-arm-64-x86-64
+- group: tool-chain-ubuntu-gcc
+
+jobs:
+- template: Matrix-Build-Job.yml
+ parameters:
+ arch_list: $(arch_list)
+ extra_build_args: CODE_COVERAGE=TRUE CC_HTML=TRUE
+ extra_install_step:
+ - script: |
+ sudo apt-get install -y mingw-w64 lcov
+ pip install lcov_cobertura pycobertura
+ displayName: Install Windows Resource Compiler for Linux & Code Coverage Tools
+ tool_chain_tag: $(tool_chain_tag)
+ vm_image: $(vm_image)
diff --git a/.azurepipelines/Windows-VS.yml b/.azurepipelines/Windows-VS.yml
index 98063165..1e8357e6 100644
--- a/.azurepipelines/Windows-VS.yml
+++ b/.azurepipelines/Windows-VS.yml
@@ -1,26 +1,34 @@
-## @file
-# Azure Pipeline build file for a build using Windows and the latest Visual Studio toolchain supported.
-#
-# Copyright (c) Microsoft Corporation.
-# SPDX-License-Identifier: BSD-2-Clause-Patent
-##
-
-resources:
- repositories:
- - repository: mu_devops
- type: github
- endpoint: microsoft
- name: microsoft/mu_devops
- ref: main
-
-variables:
-- group: architectures-x86-64
-- group: tool-chain-windows-visual-studio-latest
-
-jobs:
-- template: Matrix-Build-Job.yml
- parameters:
- arch_list: $(arch_list)
- tool_chain_tag: $(tool_chain_tag)
- vm_image: $(vm_image)
-
+## @file
+# Azure Pipeline build file for a build using Windows and the latest Visual Studio toolchain supported.
+#
+# IMPORTANT: This file requires the local repo to contain a .azurepipelines/Matrix-Build-Job.yml file that
+# performs the actual build steps for the configurations and packages supported by the repo.
+#
+# NOTE: This file is automatically synchronized from Mu DevOps. Update the original file there
+# instead of the file in this repo.
+#
+# - Mu DevOps Repo: https://github.com/microsoft/mu_devops
+# - File Sync Settings: https://github.com/microsoft/mu_devops/blob/main/.sync/Files.yml
+#
+# Copyright (c) Microsoft Corporation.
+# SPDX-License-Identifier: BSD-2-Clause-Patent
+##
+
+resources:
+ repositories:
+ - repository: mu_devops
+ type: github
+ endpoint: microsoft
+ name: microsoft/mu_devops
+ ref: main
+
+variables:
+- group: architectures-x86-64
+- group: tool-chain-windows-visual-studio-latest
+
+jobs:
+- template: Matrix-Build-Job.yml
+ parameters:
+ arch_list: $(arch_list)
+ tool_chain_tag: $(tool_chain_tag)
+ vm_image: $(vm_image)
diff --git a/.github/ISSUE_TEMPLATE/bug_report.yml b/.github/ISSUE_TEMPLATE/bug_report.yml
new file mode 100644
index 00000000..12b5b4bd
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/bug_report.yml
@@ -0,0 +1,143 @@
+# Project Mu GitHub Bug Report Template
+#
+# NOTE: This file is automatically synchronized from Mu DevOps. Update the original file there
+# instead of the file in this repo.
+#
+# - Mu DevOps Repo: https://github.com/microsoft/mu_devops
+# - File Sync Settings: https://github.com/microsoft/mu_devops/blob/main/.sync/Files.yml
+#
+# Copyright (c) Microsoft Corporation.
+# SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+
+name: 🐛 Bug Report
+description: File a bug report
+title: "[Bug]:
"
+labels: ["type:bug", "state:needs-triage"]
+
+body:
+ - type: markdown
+ attributes:
+ value: |
+ 👋 Thanks for taking the time to fill out this bug report!
+
+ - type: checkboxes
+ attributes:
+ label: Is there an existing issue for this?
+ description: Please search to see if an issue already exists for the bug you encountered.
+ options:
+ - label: I have searched existing issues
+ required: true
+
+ - type: textarea
+ id: current_behavior
+ attributes:
+ label: Current Behavior
+ description: A concise description of the bug that you're experiencing.
+ validations:
+ required: true
+
+ - type: textarea
+ id: expected_behavior
+ attributes:
+ label: Expected Behavior
+ description: A concise description of what you expected to happen.
+ validations:
+ required: true
+
+ - type: textarea
+ id: steps_to_reproduce
+ attributes:
+ label: Steps To Reproduce
+ description: Steps to reproduce the behavior.
+ placeholder: |
+
+ 1. In this environment...
+ 2. With this config...
+ 3. Boot to '...'
+ 4. Change option '...'
+ 4. See error...
+ validations:
+ required: true
+
+ - type: textarea
+ id: build_environment
+ attributes:
+ label: Build Environment
+ description: |
+ examples:
+ - **OS**: Ubuntu 20.04 or Windows 11...
+ - **Tool Chain**: GCC5 or VS2022 or CLANGPDB...
+ - **Targets Impacted**: RELEASE, DEBUG, NO-TARGET, NOOPT...
+ value: |
+ - OS(s):
+ - Tool Chain(s):
+ - Targets Impacted:
+ render: markdown
+ validations:
+ required: true
+
+ - type: textarea
+ id: version_info
+ attributes:
+ label: Version Information
+ description: What version of this repo reproduces the problem?
+ placeholder: |
+ Commit:
+ -or-
+ Tag:
+ render: text
+ validations:
+ required: true
+
+ - type: markdown
+ attributes:
+ value: |
+ **Urgency Key**
+ - 🟢 **Low**
+ - A minor change with little to no important functional impact
+ - It is not important to fix this in a specific time frame
+ - 🟡 **Medium**
+ - An important change with a functional impact
+ - Will be prioritized above *low* issues in the normal course of development
+ - 🔥 **High**
+ - A critical change that has a significant functional impact
+ - Must be fixed immediately
+
+ - type: dropdown
+ id: urgency
+ attributes:
+ label: Urgency
+ description: How urgent is it to fix this bug?
+ multiple: false
+ options:
+ - Low
+ - Medium
+ - High
+ validations:
+ required: true
+
+ - type: dropdown
+ id: fix_owner
+ attributes:
+ label: Are you going to fix this?
+ description: Indicate if you are going to fix this or requesting someone else fix it.
+ multiple: false
+ options:
+ - I will fix it
+ - Someone else needs to fix it
+ validations:
+ required: true
+
+ - type: textarea
+ id: anything_else
+ attributes:
+ label: Anything else?
+ description: |
+ Links? References? Anything that will give us more context about the issue you are encountering.
+
+ Serial debug logs and/or debugger logs are especially helpful!
+
+ Tip: You can attach images or log files by clicking this area to highlight it and then dragging files in.
+ validations:
+ required: false
diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml
new file mode 100644
index 00000000..f9b067c6
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/config.yml
@@ -0,0 +1,20 @@
+# Project Mu GitHub Issue Configuration File
+#
+# NOTE: This file is automatically synchronized from Mu DevOps. Update the original file there
+# instead of the file in this repo.
+#
+# - Mu DevOps Repo: https://github.com/microsoft/mu_devops
+# - File Sync Settings: https://github.com/microsoft/mu_devops/blob/main/.sync/Files.yml
+#
+# Copyright (c) Microsoft Corporation.
+# SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+
+contact_links:
+ - name: 📃 Project Mu Documentation
+ url: https://microsoft.github.io/mu/
+ about: Goals, principles, repo layout, build instructions, and more.
+
+ - name: 🔐 Security Reporting Policy
+ url: https://github.com/microsoft/.github/blob/main/SECURITY.md
+ about: A special process is used to report security vulnerabilities.
diff --git a/.github/ISSUE_TEMPLATE/documentation_request.yml b/.github/ISSUE_TEMPLATE/documentation_request.yml
new file mode 100644
index 00000000..d8ed7cf0
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/documentation_request.yml
@@ -0,0 +1,53 @@
+# Project Mu GitHub Documentation Request Template
+#
+# NOTE: This file is automatically synchronized from Mu DevOps. Update the original file there
+# instead of the file in this repo.
+#
+# - Mu DevOps Repo: https://github.com/microsoft/mu_devops
+# - File Sync Settings: https://github.com/microsoft/mu_devops/blob/main/.sync/Files.yml
+#
+# Copyright (c) Microsoft Corporation.
+# SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+
+name: 📖 Documentation Request
+description: Request a documentation change
+title: "[Documentation]: "
+labels: ["type:documentation", "state:needs-triage"]
+
+body:
+ - type: markdown
+ attributes:
+ value: |
+ 👋 Thanks for taking the time to help us improve our documentation!
+
+ - type: textarea
+ id: request_description
+ attributes:
+ label: Request Description
+ description: A clear and concise description of what needs to change.
+ validations:
+ required: true
+
+ - type: dropdown
+ id: request_owner
+ attributes:
+ label: Are you going to make the change?
+ description: Indicate if you are going to make this change or requesting someone else make it.
+ multiple: false
+ options:
+ - I will make the change
+ - Someone else needs to make the change
+ validations:
+ required: true
+
+ - type: textarea
+ id: anything_else
+ attributes:
+ label: Anything else?
+ description: |
+ Links? References? Anything that will give us more context about the request.
+
+ Tip: You can attach images or log files by clicking this area to highlight it and then dragging files in.
+ validations:
+ required: false
diff --git a/.github/ISSUE_TEMPLATE/feature_request.yml b/.github/ISSUE_TEMPLATE/feature_request.yml
new file mode 100644
index 00000000..28bf8842
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/feature_request.yml
@@ -0,0 +1,96 @@
+# Project Mu GitHub Feature Request Template
+#
+# NOTE: This file is automatically synchronized from Mu DevOps. Update the original file there
+# instead of the file in this repo.
+#
+# - Mu DevOps Repo: https://github.com/microsoft/mu_devops
+# - File Sync Settings: https://github.com/microsoft/mu_devops/blob/main/.sync/Files.yml
+#
+# Copyright (c) Microsoft Corporation.
+# SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+
+name: 🚀 Feature Request
+description: Request a feature change
+title: "[Feature]: "
+labels: ["type:feature-request", "state:needs-triage"]
+
+body:
+ - type: markdown
+ attributes:
+ value: |
+ 👋 Thanks for taking the time to help us improve our features!
+
+ - type: textarea
+ id: feature_overview
+ attributes:
+ label: Feature Overview
+ description: Provide a high-level summary of your feature request.
+ validations:
+ required: true
+
+ - type: textarea
+ id: solution_overview
+ attributes:
+ label: Solution Overview
+ description: Give a clear and concise description of what you want to happen.
+ validations:
+ required: true
+
+ - type: textarea
+ id: alternatives_considered
+ attributes:
+ label: Alternatives Considered
+ description: Describe alternatives you've considered.
+ validations:
+ required: false
+
+ - type: markdown
+ attributes:
+ value: |
+ **Urgency Key**
+ - 🟢 **Low**
+ - A minor enhancement
+ - It is not important to address this request in a specific time frame
+ - 🟡 **Medium**
+ - An important enhancement
+ - Will be prioritized above *low* requests in the normal course of development
+ - 🔥 **High**
+ - A critical enhancement with significant value
+ - Should be prioritized above *low* and *medium* requests
+
+ - type: dropdown
+ id: urgency
+ attributes:
+ label: Urgency
+ description: How urgent is it to resolve this feature request?
+ multiple: false
+ options:
+ - Low
+ - Medium
+ - High
+ validations:
+ required: true
+
+ - type: dropdown
+ id: request_owner
+ attributes:
+ label: Are you going to implement the feature request?
+ description: Indicate if you are going to do the work to close this feature request.
+ multiple: false
+ options:
+ - I will implement the feature
+ - Someone else needs to implement the feature
+ validations:
+ required: true
+
+ - type: textarea
+ id: anything_else
+ attributes:
+ label: Anything else?
+ description: |
+ Links? References? Anything that will give us more context about the feature you are requesting.
+
+ Tip: You can attach images or log files by clicking this area to highlight it and then dragging files in.
+ validations:
+ required: false
diff --git a/.github/dependabot.yml b/.github/dependabot.yml
index 51a7e915..bfd0adc4 100644
--- a/.github/dependabot.yml
+++ b/.github/dependabot.yml
@@ -2,18 +2,47 @@
# Dependabot configuration file to enable GitHub services for managing and updating
# dependencies.
#
-# Copyright (c) Microsoft Corporation. All rights reserved.
+# NOTE: This file is automatically synchronized from Mu DevOps. Update the original file there
+# instead of the file in this repo.
+#
+# This dependabot file is limited to syncing the following type of dependencies. Other files
+# are already available in Mu DevOps to sync other dependency types.
+# - GitHub Actions (`github-actions`)
+# - Python PIP Modules (`pip`)
+#
+# - Mu DevOps Repo: https://github.com/microsoft/mu_devops
+# - File Sync Settings: https://github.com/microsoft/mu_devops/blob/main/.sync/Files.yml
+#
+# Copyright (c) Microsoft Corporation.
# SPDX-License-Identifier: BSD-2-Clause-Patent
#
-# Please see the documentation for all configuration options:
+# Please see the documentation for all dependabot configuration options:
# https://docs.github.com/github/administering-a-repository/configuration-options-for-dependency-updates
##
+
version: 2
+
updates:
- - package-ecosystem: "pip" # See documentation for possible values
- directory: "/" # Location of package manifests
+ - package-ecosystem: "github-actions"
+ directory: "/"
+ schedule:
+ interval: "weekly"
+ day: "monday"
+ commit-message:
+ prefix: "GitHub Action"
+ labels:
+ - "type:dependencies"
+ reviewers:
+ - "microsoft/project-mu-dependency-reviewers"
+
+ - package-ecosystem: "pip"
+ directory: "/"
schedule:
interval: "daily"
commit-message:
- # Prefix all commit messages with "pip"
prefix: "pip"
+ labels:
+ - "language:python"
+ - "type:dependencies"
+ reviewers:
+ - "microsoft/project-mu-dependency-reviewers"
diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md
new file mode 100644
index 00000000..1004868c
--- /dev/null
+++ b/.github/pull_request_template.md
@@ -0,0 +1,20 @@
+## Description
+
+<_Please include a description of the change and why this change was made._>
+
+For each item, place an "x" in between `[` and `]` if true. Example: `[x]`.
+_(you can also check items in the GitHub UI)_
+
+- [ ] Impacts functionality?
+- [ ] Impacts security?
+- [ ] Breaking change?
+- [ ] Includes tests?
+- [ ] Includes documentation?
+
+## How This Was Tested
+
+<_Please describe the test(s) that were run to verify the changes._>
+
+## Integration Instructions
+
+<_Describe how these changes should be integrated. Use N/A if nothing is required._>
diff --git a/.github/workflows/label-issues.yml b/.github/workflows/label-issues.yml
new file mode 100644
index 00000000..2ad02978
--- /dev/null
+++ b/.github/workflows/label-issues.yml
@@ -0,0 +1,34 @@
+# This workflow automatically applies labels to GitHub issues and pull requests based on the
+# file paths in a pull request or content in the body of an issue or pull request.
+#
+# NOTE: This file is automatically synchronized from Mu DevOps. Update the original file there
+# instead of the file in this repo.
+#
+# NOTE: This file uses a reusable workflow. Do not make changes to the file that should be made
+# in the common/reusable workflow.
+#
+# - Mu DevOps Repo: https://github.com/microsoft/mu_devops
+# - File Sync Settings: https://github.com/microsoft/mu_devops/blob/main/.sync/Files.yml
+#
+# Copyright (c) Microsoft Corporation.
+# SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+
+name: Apply Issue and PR Labels
+
+on:
+ issues:
+ types:
+ - edited
+ - opened
+ pull_request_target:
+ types:
+ - edited
+ - opened
+ - reopened
+ - synchronize
+ workflow_dispatch:
+
+jobs:
+ apply:
+ uses: microsoft/mu_devops/.github/workflows/Labeler.yml@main
diff --git a/.github/workflows/label-issues/file-paths.yml b/.github/workflows/label-issues/file-paths.yml
new file mode 100644
index 00000000..5cd3a7bf
--- /dev/null
+++ b/.github/workflows/label-issues/file-paths.yml
@@ -0,0 +1,12 @@
+# Specifies labels to apply to issues and pull requests based on file path patterns in Project Mu repositories.
+#
+# Copyright (c) Microsoft Corporation.
+# SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+# For more information, see:
+# https://github.com/actions/labeler
+
+# Maintenance: Keep labels organized in ascending alphabetical order - easier to scan, identify duplicates, etc.
+
+language:python:
+ - '**/*.py'
diff --git a/.github/workflows/label-issues/regex-pull-requests.yml b/.github/workflows/label-issues/regex-pull-requests.yml
new file mode 100644
index 00000000..175d3c3e
--- /dev/null
+++ b/.github/workflows/label-issues/regex-pull-requests.yml
@@ -0,0 +1,24 @@
+# Specifies labels to apply to pull requests in Project Mu repositories based on regular expressions.
+#
+# Copyright (c) Microsoft Corporation.
+# SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+# For more information, see:
+# https://github.com/github/issue-labeler
+
+# Maintenance: Keep labels organized in ascending alphabetical order - easier to scan, identify duplicates, etc.
+
+impact:breaking-change:
+ - '\s*-\s*\[\s*[x|X]\s*\] Breaking change\?'
+
+impact:non-functional:
+ - '\s*-\s*\[\s*[x|X]\s*\] Impacts functionality\?'
+
+impact:security:
+ - '\s*-\s*\[\s*[x|X]\s*\] Impacts security\?'
+
+impact:testing:
+ - '\s*-\s*\[\s*[x|X]\s*\] Includes tests\?'
+
+type:documentation:
+ - '\s*-\s*\[\s*[x|X]\s*\] Includes documentation\?'
diff --git a/.github/workflows/label-sync.yml b/.github/workflows/label-sync.yml
index e65acc45..e7b493ee 100644
--- a/.github/workflows/label-sync.yml
+++ b/.github/workflows/label-sync.yml
@@ -3,6 +3,12 @@
# All repos should sync at the same time.
# '0 0,12 * * *''
#
+# NOTE: This file is automatically synchronized from Mu DevOps. Update the original file there
+# instead of the file in this repo.
+#
+# - Mu DevOps Repo: https://github.com/microsoft/mu_devops
+# - File Sync Settings: https://github.com/microsoft/mu_devops/blob/main/.sync/Files.yml
+#
# Copyright (c) Microsoft Corporation.
# SPDX-License-Identifier: BSD-2-Clause-Patent
#
diff --git a/.github/workflows/stale.yml b/.github/workflows/stale.yml
index ce96011c..043c26b8 100644
--- a/.github/workflows/stale.yml
+++ b/.github/workflows/stale.yml
@@ -1,5 +1,11 @@
# This workflow warns and then closes issues and PRs that have had no activity for a specified amount of time.
#
+# NOTE: This file is automatically synchronized from Mu DevOps. Update the original file there
+# instead of the file in this repo.
+#
+# - Mu DevOps Repo: https://github.com/microsoft/mu_devops
+# - File Sync Settings: https://github.com/microsoft/mu_devops/blob/main/.sync/Files.yml
+#
# Copyright (c) Microsoft Corporation.
# SPDX-License-Identifier: BSD-2-Clause-Patent
#
diff --git a/.markdownlint.yaml b/.markdownlint.yaml
index 83b980f9..d9ec238b 100644
--- a/.markdownlint.yaml
+++ b/.markdownlint.yaml
@@ -1,14 +1,21 @@
-## @file
-# markdownlint configuration
-#
-# Copyright (c) Microsoft Corporation
-# SPDX-License-Identifier: BSD-2-Clause-Patent
-##
-
-# Rules can be found here: https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md
-# Config info: https://github.com/DavidAnson/markdownlint#configuration
-{
- "default": true,
- "MD013": {"line_length": 120, "code_blocks": false, "tables": false},
- "MD033": {"allowed_elements": ["br"]}
-}
+## @file
+# markdownlint configuration
+#
+# NOTE: This file is automatically synchronized from Mu DevOps. Update the original file there
+# instead of the file in this repo.
+#
+# - Mu DevOps Repo: https://github.com/microsoft/mu_devops
+# - File Sync Settings: https://github.com/microsoft/mu_devops/blob/main/.sync/Files.yml
+#
+# Copyright (c) Microsoft Corporation.
+# SPDX-License-Identifier: BSD-2-Clause-Patent
+##
+
+# Rules can be found here: https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md
+# Config info: https://github.com/DavidAnson/markdownlint#configuration
+
+{
+ "default": true,
+ "MD013": {"line_length": 120, "code_blocks": false, "tables": false},
+ "MD033": {"allowed_elements": ["br"]}
+}
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
new file mode 100644
index 00000000..b7df7bff
--- /dev/null
+++ b/CONTRIBUTING.md
@@ -0,0 +1,51 @@
+# Contributing to Project Mu
+
+Welcome, and thank you for your interest in contributing to Project Mu!
+
+There are many ways in which you can contribute, beyond writing code. The goal of this document is to provide a
+high-level overview of how you can get involved.
+
+If this is your first time working with Project Mu, please keep in mind that many project details are maintained in
+the [Project Mu Documentation](https://microsoft.github.io/mu/).
+
+## Asking Questions
+
+Have a question? Rather than opening an issue, please post your question under the `Q&A` category in the `Discussions`
+section of the relevant Project Mu GitHub repo.
+
+## Reporting Issues
+
+Every Project Mu repo has an `Issues` section. Bug reports, feature requests, and documentation requests can all be
+submitted in the issues section.
+
+### Identify Where to Report
+
+Project Mu is distributed across multiple repositories. Use features such as issues and discussions in the repository
+most relevant to the topic.
+
+Although we prefer items to be filed in the most relevant repo, if you're unsure which repo is most relevant, the item
+can be filed in the [Project Mu Documentation Repo](https://github.com/microsoft/mu) and we will review the request and
+move it to the relevant repo if necessary.
+
+### Look For an Existing Issue
+
+Before you create a new issue, please do a search in the issues section of the relevant repo to see if the issue or
+feature request has already been filed.
+
+If you find your issue already exists, make relevant comments and add your
+[reaction](https://github.com/blog/2119-add-reactions-to-pull-requests-issues-and-comments). Use a reaction in place
+of a "+1" comment:
+
+* 👍 - upvote
+* 👎 - downvote
+
+If you cannot find an existing issue that describes your bug or feature, create a new issue using the guidelines below.
+
+### Follow Your Issue
+
+Please continue to follow your request after it is submitted to assist with any additional information that might be
+requested.
+
+## Thank You
+
+Thank you for your interest in Project Mu and taking the time to contribute!
diff --git a/LICENSE.txt b/LICENSE.txt
index 6de3d8cd..28acc527 100644
--- a/LICENSE.txt
+++ b/LICENSE.txt
@@ -1,4 +1,4 @@
-BSD-2-Clause-Patent License
-
-Copyright (C) Microsoft Corporation. All rights reserved.
-SPDX-License-Identifier: BSD-2-Clause-Patent
+BSD-2-Clause-Patent License
+
+Copyright (C) Microsoft Corporation. All rights reserved.
+SPDX-License-Identifier: BSD-2-Clause-Patent