From 584eeb02187251d5ee000b0b5d2e5ca0878cd685 Mon Sep 17 00:00:00 2001
From: Yun Peng <pcloudy@google.com>
Date: Tue, 10 Feb 2026 12:28:43 +0000
Subject: [PATCH] Add PR template

---
 .github/PULL_REQUEST_TEMPLATE/bug_fix.md      | 41 +++++++++++++++++++
 .github/PULL_REQUEST_TEMPLATE/cherry_pick.md  | 36 ++++++++++++++++
 .../PULL_REQUEST_TEMPLATE/documentation.md    | 24 +++++++++++
 .../pull_request_template.md                  | 38 +++++++++++++++++
 4 files changed, 139 insertions(+)
 create mode 100644 .github/PULL_REQUEST_TEMPLATE/bug_fix.md
 create mode 100644 .github/PULL_REQUEST_TEMPLATE/cherry_pick.md
 create mode 100644 .github/PULL_REQUEST_TEMPLATE/documentation.md
 create mode 100644 .github/PULL_REQUEST_TEMPLATE/pull_request_template.md

diff --git a/.github/PULL_REQUEST_TEMPLATE/bug_fix.md b/.github/PULL_REQUEST_TEMPLATE/bug_fix.md
new file mode 100644
index 00000000000000..435f0ac4579542
--- /dev/null
+++ b/.github/PULL_REQUEST_TEMPLATE/bug_fix.md
@@ -0,0 +1,41 @@
+<!--
+Thank you for fixing a bug in Bazel!
+Please read the contribution guidelines: https://bazel.build/contribute.html
+-->
+
+### Description
+<!-- Provide a clear description of the bug and how your changes fix it. -->
+
+### Fixes # (Issue link)
+<!-- MANDATORY: Link to the bug issue being fixed. For example: "Fixes #1234" -->
+
+### Related Issues/PRs
+<!-- List any other related issues or pull requests here. -->
+
+### Category
+<!-- Please select the most relevant category/categories for this bug fix. -->
+- [ ] Android
+- [ ] C++ Rules / Objective-C Rules
+- [ ] CLI
+- [ ] Configurability
+- [ ] Core
+- [ ] Documentation
+- [ ] External Dependency (Bzlmod)
+- [ ] Java Rules
+- [ ] Loading API
+- [ ] Local Execution / Remote Execution
+- [ ] Performance
+- [ ] Python Rules
+- [ ] Rules API / Starlark Integration / Starlark Interpreter
+- [ ] Other
+
+### Regression?
+- [ ] Yes (This bug was not present in a previous version of Bazel)
+- [ ] No
+
+### Verification
+<!-- Describe the tests you ran to verify the fix. Include a reproduction case if possible. -->
+
+### Documentation
+- [ ] Documentation updated (if applicable)
+- [ ] No documentation update required
diff --git a/.github/PULL_REQUEST_TEMPLATE/cherry_pick.md b/.github/PULL_REQUEST_TEMPLATE/cherry_pick.md
new file mode 100644
index 00000000000000..02c57235cf7d2a
--- /dev/null
+++ b/.github/PULL_REQUEST_TEMPLATE/cherry_pick.md
@@ -0,0 +1,36 @@
+<!--
+This template is for cherry-picking a commit into a release branch.
+Full Bazel cherry-pick procedure: https://bazel.build/contribute.html#release-cherry-picks
+-->
+
+### Cherry-pick Request
+<!-- Provide a brief description of why this cherry-pick is needed. -->
+
+### Original Commit(s)
+<!-- Link to the original commit(s) in the main branch. e.g. https://github.com/bazelbuild/bazel/commit/abcdef123456 -->
+
+### Original PR(s)
+<!-- Link to the original Pull Request(s). e.g. #12345 -->
+
+### Fixes # (Issue link)
+<!-- If this cherry-pick fixes an issue, link it here. -->
+
+### Category
+<!-- Please select the most relevant category/categories. -->
+- [ ] Android
+- [ ] C++ Rules / Objective-C Rules
+- [ ] CLI
+- [ ] Configurability
+- [ ] Core
+- [ ] Documentation
+- [ ] External Dependency (Bzlmod)
+- [ ] Java Rules
+- [ ] Loading API
+- [ ] Local Execution / Remote Execution
+- [ ] Performance
+- [ ] Python Rules
+- [ ] Rules API / Starlark Integration / Starlark Interpreter
+- [ ] Other
+
+### Verification
+<!-- Describe how you verified this cherry-pick (e.g. ran tests on the target branch). -->
diff --git a/.github/PULL_REQUEST_TEMPLATE/documentation.md b/.github/PULL_REQUEST_TEMPLATE/documentation.md
new file mode 100644
index 00000000000000..4f7169da612311
--- /dev/null
+++ b/.github/PULL_REQUEST_TEMPLATE/documentation.md
@@ -0,0 +1,24 @@
+<!--
+Thank you for improving Bazel's documentation!
+-->
+
+### Description
+<!-- Please describe the changes to the documentation. -->
+
+### Related Issues
+<!-- If this PR is related to an existing issue, please link it here. -->
+
+### Documentation Type
+- [ ] New feature documentation
+- [ ] Fix existing documentation
+- [ ] Tutorial / Guide
+- [ ] FAQ
+- [ ] Reference docs (Starlark API, Built-ins, etc.)
+
+### Preview Plan
+<!-- How can reviewers preview the changes? (e.g. built site locally, or specific file changes) -->
+
+### Verification
+- [ ] Spell check performed
+- [ ] Links verified
+- [ ] Code snippets verified
diff --git a/.github/PULL_REQUEST_TEMPLATE/pull_request_template.md b/.github/PULL_REQUEST_TEMPLATE/pull_request_template.md
new file mode 100644
index 00000000000000..6f4ea9c80e1fb2
--- /dev/null
+++ b/.github/PULL_REQUEST_TEMPLATE/pull_request_template.md
@@ -0,0 +1,38 @@
+<!--
+Thank you for contributing to Bazel!
+Please read the contribution guidelines: https://bazel.build/contribute.html
+-->
+
+### Description
+<!-- Please provide a clear and concise description of the changes in this PR. -->
+
+### Fixes # (Issue link)
+<!-- If this PR fixes an existing issue, please link it here. For example: "Fixes #1234" -->
+
+### Related Issues/PRs
+<!-- List any other related issues or pull requests here. -->
+
+### Category
+<!-- Please select the most relevant category/categories for this PR. -->
+- [ ] Android
+- [ ] C++ Rules / Objective-C Rules
+- [ ] CLI
+- [ ] Configurability
+- [ ] Core
+- [ ] Documentation
+- [ ] External Dependency (Bzlmod)
+- [ ] Java Rules
+- [ ] Loading API
+- [ ] Local Execution / Remote Execution
+- [ ] Performance
+- [ ] Python Rules
+- [ ] Rules API / Starlark Integration / Starlark Interpreter
+- [ ] Other
+
+### Verification
+<!-- Describe the tests you ran to verify your changes. Include any relevant commands and their output. -->
+
+### Documentation
+<!-- Mention if you've updated the documentation or if a follow-up task is needed. -->
+- [ ] Documentation updated
+- [ ] No documentation update required