From 532ddbf9195289cfdc9a79cc4c919fe6b5a13ef6 Mon Sep 17 00:00:00 2001
From: Max Jones <14077947+maxrjones@users.noreply.github.com>
Date: Fri, 26 Jun 2026 12:54:13 -0400
Subject: [PATCH 1/3] docs: add reviewer guidance and author attestation to PR
 template

---
 .github/PULL_REQUEST_TEMPLATE.md | 17 +++++++++++++++--
 1 file changed, 15 insertions(+), 2 deletions(-)

diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md
index c36428b300..f904fb5316 100644
--- a/.github/PULL_REQUEST_TEMPLATE.md
+++ b/.github/PULL_REQUEST_TEMPLATE.md
@@ -1,6 +1,19 @@
-[Description of PR]
+## Summary
+
+[Describe what this PR changes and why, in your own words.]
+
+## For reviewers
+
+[What would you most value a second look at? What are you already confident in? For a refactor, say whether behavior is meant to be unchanged.]
+
+## Author attestation
+
+- [ ] I am a human, these are my changes, and I have reviewed and understood every change and can explain why each is correct.
+
+AI coding assistance is welcome, but a human must be the author and is responsible for the contents of the PR. The description and any review responses must be in your own words. Please read [AI-assisted contributions](https://zarr.readthedocs.io/en/stable/contributing/#ai-assisted-contributions) before opening.
+
+## TODO
 
-TODO:
 * [ ] Add unit tests and/or doctests in docstrings
 * [ ] Add docstrings and API docs for any new/modified user-facing classes and functions
 * [ ] New/modified features documented in `docs/user-guide/*.md`

From ad34439b7919bbf1f6881cfbd7e4c775221fc36d Mon Sep 17 00:00:00 2001
From: Max Jones <14077947+maxrjones@users.noreply.github.com>
Date: Fri, 26 Jun 2026 13:02:51 -0400
Subject: [PATCH 2/3] docs: recommend conventional commits style PR titles

---
 .github/PULL_REQUEST_TEMPLATE.md | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md
index f904fb5316..f1ef6777a8 100644
--- a/.github/PULL_REQUEST_TEMPLATE.md
+++ b/.github/PULL_REQUEST_TEMPLATE.md
@@ -1,3 +1,8 @@
+<!-- The PR title becomes the squash-merge commit on main. Please use a descriptive,
+     Conventional Commits-style title, e.g. "fix: handle empty chunk in v3 reader".
+     This is the commit type (feat/fix/docs/chore/...), not the changelog category.
+     See https://www.conventionalcommits.org/en/v1.0.0/ -->
+
 ## Summary
 
 [Describe what this PR changes and why, in your own words.]

From edc182d0e5fee2373cc0733a5c10df0273763864 Mon Sep 17 00:00:00 2001
From: Max Jones <14077947+maxrjones@users.noreply.github.com>
Date: Fri, 26 Jun 2026 13:51:11 -0400
Subject: [PATCH 3/3] docs: change example

---
 .github/PULL_REQUEST_TEMPLATE.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md
index f1ef6777a8..1d12aa02eb 100644
--- a/.github/PULL_REQUEST_TEMPLATE.md
+++ b/.github/PULL_REQUEST_TEMPLATE.md
@@ -1,5 +1,5 @@
 <!-- The PR title becomes the squash-merge commit on main. Please use a descriptive,
-     Conventional Commits-style title, e.g. "fix: handle empty chunk in v3 reader".
+     Conventional Commits-style title, e.g. "fix: handle 0-d arrays in `save_array`".
      This is the commit type (feat/fix/docs/chore/...), not the changelog category.
      See https://www.conventionalcommits.org/en/v1.0.0/ -->