From 305955eb05444a6ad755eb72732654ac10c049e9 Mon Sep 17 00:00:00 2001
From: openhands <openhands@all-hands.dev>
Date: Mon, 6 Apr 2026 20:33:56 +0000
Subject: [PATCH 1/2] Copy PR template from OpenHands/OpenHands repository

- Replace simple PR template with comprehensive template from main OpenHands repo
- Add sections for Why, Summary, Issue Number, How to Test, Video/Screenshots, Type, and Notes
- Include checklist for human testing and guidance for AI/LLM agents

Fixes #440
---
 .github/pull_request_template.md | 48 ++++++++++++++++++++++++++++++--
 1 file changed, 45 insertions(+), 3 deletions(-)

diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md
index b969d6c98..30a657700 100644
--- a/.github/pull_request_template.md
+++ b/.github/pull_request_template.md
@@ -1,4 +1,46 @@
-- [ ] I have read and reviewed the documentation changes to the best of my ability.
-- [ ] If the change is significant, I have run the documentation site locally and confirmed it renders as expected.
+<!-- Keep this PR as draft until it is ready for review. -->
 
-**Summary of changes**
+<!-- AI/LLM agents: be concise and specific. Do not check the box below. -->
+
+- [ ] A human has tested these changes.
+
+---
+
+## Why
+
+<!-- Describe problem, motivation, etc.-->
+
+## Summary
+
+<!-- 1-3 bullets describing what changed. -->
+-
+
+## Issue Number
+<!-- Required if there is a relevant issue to this PR. -->
+
+## How to Test
+
+<!--
+Required. Share the steps for the reviewer to be able to test your PR. e.g. You can test by running `npm install` then `npm build dev`.
+
+If you could not test this, say why.
+-->
+
+## Video/Screenshots
+
+<!--
+Provide a video or screenshots of testing your PR. e.g. you added a new feature to the gui, show us the video of you testing it successfully.
+
+-->
+
+## Type
+
+- [ ] Bug fix
+- [ ] Feature
+- [ ] Refactor
+- [ ] Breaking change
+- [ ] Docs / chore
+
+## Notes
+
+<!-- Optional: migrations, config changes, rollout concerns, follow-ups, or anything reviewers should know. -->
\ No newline at end of file

From ab22f19f99c1dd04292c405b540ab5710234cd75 Mon Sep 17 00:00:00 2001
From: openhands <openhands@all-hands.dev>
Date: Mon, 6 Apr 2026 22:14:04 +0000
Subject: [PATCH 2/2] Add doc-specific guidance to PR template

- Add checklist for local preview validation
- Make testing section flexible for simple doc changes
- Clarify video/screenshot requirements for docs
---
 .github/pull_request_template.md | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md
index 30a657700..9b9c0f003 100644
--- a/.github/pull_request_template.md
+++ b/.github/pull_request_template.md
@@ -3,6 +3,7 @@
 <!-- AI/LLM agents: be concise and specific. Do not check the box below. -->
 
 - [ ] A human has tested these changes.
+- [ ] For significant changes, I have previewed the docs site locally (`mint dev`) and confirmed rendering
 
 ---
 
@@ -21,16 +22,15 @@
 ## How to Test
 
 <!--
-Required. Share the steps for the reviewer to be able to test your PR. e.g. You can test by running `npm install` then `npm build dev`.
-
-If you could not test this, say why.
+For code changes: Share steps to test your changes.
+For simple documentation fixes (typos, formatting, links): You can skip this or briefly state what you verified.
 -->
 
 ## Video/Screenshots
 
 <!--
-Provide a video or screenshots of testing your PR. e.g. you added a new feature to the gui, show us the video of you testing it successfully.
-
+For GUI/visual changes: Provide screenshots or video.
+For documentation content: Provide a screenshot of the rendered page if the change affects layout/formatting, or state "N/A - text-only change".
 -->
 
 ## Type