From 6cb5d6e2e196e53f7b3a191949d42b9145fc0da7 Mon Sep 17 00:00:00 2001
From: Brent Vatne <brentvatne@gmail.com>
Date: Fri, 23 Oct 2026 21:53:37 -0700
Subject: [PATCH 1/2] PR template: ask for code examples of any change to how
 Explore is used or what it writes

---
 .github/pull_request_template.md | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md
index 0fe8807..c0cf8df 100644
--- a/.github/pull_request_template.md
+++ b/.github/pull_request_template.md
@@ -16,6 +16,21 @@ Write "No visible change" if there is none.
 | --- | --- |
 |  |  |
 
+## Code examples
+
+<!--
+Required for any change to how Explore is used or what it writes: a CLI command or flag,
+config.yaml, a workflow template, a file format (a replay or flows file, report JSON), or a
+public type. Show it in use as a reader would write it: the command with its flags, the config
+or file it reads, and what it prints or writes, trimmed to the lines that matter. When existing
+usage changes, show it before and after.
+Write "No change to usage" if there is none.
+-->
+
+```sh
+
+```
+
 ## Testing
 
 <!-- What you ran and what you checked by hand. -->

From 4ae007788e29dbec8d487c320afb99f1271e7563 Mon Sep 17 00:00:00 2001
From: Brent Vatne <brentvatne@gmail.com>
Date: Fri, 23 Oct 2026 21:55:27 -0700
Subject: [PATCH 2/2] PR template: an optional Try it section with a preview or
 commands reviewers can run

---
 .github/pull_request_template.md | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md
index c0cf8df..9d4ea64 100644
--- a/.github/pull_request_template.md
+++ b/.github/pull_request_template.md
@@ -31,6 +31,19 @@ Write "No change to usage" if there is none.
 
 ```
 
+## Try it
+
+<!--
+Optional, but recommended: something a reviewer can open or run to see the change for themselves.
+- A Viewer change: the Viewer preview comment on this PR links a live build. Name the report,
+  screen and steps to look at.
+- A capture or report change: a hosted report from a run of this branch (explore:binary,
+  explore:session or capture with --upload), or an app pull request whose review ran this branch.
+- Otherwise: the commands that run it from a checkout of this branch, for example
+  `npm ci && npm run build`, then `node dist/cli.js <command>`, with any app or file it needs.
+Write "Nothing to try" if there is nothing a reviewer could run.
+-->
+
 ## Testing
 
 <!-- What you ran and what you checked by hand. -->