From d9123bb231e8bd83cf23452c5dc8c3c5f6c9fa6e Mon Sep 17 00:00:00 2001
From: Oleksandr Ivantsiv <oivantsiv@nvidia.com>
Date: Wed, 20 May 2026 23:32:24 +0000
Subject: [PATCH] [chore/github]: Standardize GitHub PR description template

Replace legacy templates with unified pull_request_template.md
(description, type, approach, documentation).

Signed-off-by: Oleksandr Ivantsiv <oivantsiv@nvidia.com>
---
 .github/copilot-instructions.md  |  5 +++
 .github/pull_request_template.md | 66 +++++++++++++++-----------------
 2 files changed, 36 insertions(+), 35 deletions(-)

diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md
index 62b36c23a..9e69ad659 100644
--- a/.github/copilot-instructions.md
+++ b/.github/copilot-instructions.md
@@ -108,6 +108,11 @@ go tool cover -html=coverage.out
 - **Go formatting**: Code MUST pass `gofmt`
 - **Proto changes**: Update generated code when modifying `.proto` files
 - **Security**: gNMI server handles authentication — be security-conscious
+- **PR description template**: Fill out all sections of the [PR template](.github/pull_request_template.md) when submitting a pull request:
+  - **Description of PR**: Summary of the change, motivation/context, reviewer entry point, and dependencies; reference issues with `fixes #xxxx` / `closes #xxxx`.
+  - **Type of change**: Mark the box(es) that apply — bug fix, new feature, refactor / cleanup, documentation update, test improvement.
+  - **Approach**: Motivation; how you did it; how you verified/tested it; any platform-specific notes.
+  - **Documentation**: Link to wiki / doc updates relevant to new features or test cases.
 
 ## Common Patterns
 
diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md
index c02d193fb..f9372611b 100644
--- a/.github/pull_request_template.md
+++ b/.github/pull_request_template.md
@@ -1,49 +1,45 @@
 <!--
-     Please make sure you've read and understood our contributing guidelines:
-     https://github.com/Azure/SONiC/blob/gh-pages/CONTRIBUTING.md
+Please make sure you've read and understood our contributing guidelines;
+https://github.com/Azure/SONiC/blob/gh-pages/CONTRIBUTING.md
 
-     ** Make sure all your commits include a signature generated with `git commit -s` **
-
-     If this is a bug fix, make sure your description includes "fixes #xxxx", or
-     "closes #xxxx" or "resolves #xxxx"
-
-     Please provide the following information:
+Please provide following information to help code review process a bit easier:
+-->
+### Description of PR
+<!--
+- Please include a summary of the change and which issue is fixed.
+- Please also include relevant motivation and context. Where should reviewer start? background context?
+- List any dependencies that are required for this change.
 -->
 
-#### Why I did it
-
-#### How I did it
-
-#### How to verify it
+Summary:
+Fixes # (issue)
 
-#### Which release branch to backport (provide reason below if selected)
+### Type of change
 
 <!--
-- Note we only backport fixes to a release branch, *not* features!
-- Please also provide a reason for the backporting below.
+- Fill x for your type of change.
 - e.g.
-- [x] 202006
+- [x] Bug fix
 -->
 
-- [ ] 201811
-- [ ] 201911
-- [ ] 202006
-- [ ] 202012
-- [ ] 202106
-- [ ] 202111
+- [ ] Bug fix
+- [ ] New feature
+- [ ] Refactor / cleanup
+- [ ] Documentation update
+- [ ] Test improvement
 
-#### Description for the changelog
-<!--
-Write a short (one line) summary that describes the changes in this
-pull request for inclusion in the changelog:
--->
+### Approach
+#### What is the motivation for this PR?
 
-#### Link to config_db schema for YANG module changes
-<!--
-Provide a link to config_db schema for the table for which YANG model
-is defined
-Link should point to correct section on https://github.com/Azure/SONiC/wiki/Configuration.
--->
+#### How did you do it?
 
-#### A picture of a cute animal (not mandatory but encouraged)
+#### How did you verify/test it?
 
+#### Any platform specific information?
+
+### Documentation
+<!--
+(If it's a new feature, new test case)
+Did you update documentation/Wiki relevant to your implementation?
+Link to the wiki page?
+-->