From 78f1b09429a5ff0559a4629b2bf9fad9f069e867 Mon Sep 17 00:00:00 2001
From: Mateo Wang <277851410+mateo-berri@users.noreply.github.com>
Date: Thu, 5 Nov 2026 09:35:55 -0800
Subject: [PATCH] docs(pr-template): drop the make-me-human-readable tags from
 the handwritten description (#50183)

* docs(pr-template): replace the make-me-human-readable tags with a Human PR description section

Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>

* docs(pr-template): keep the Handwritten 1-3 sentence description heading

Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>

* docs(pr-template): add a placeholder authors replace in the handwritten description

Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>

* docs(pr-template): use an <insert handwritten description here> placeholder

Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>

* docs(pr-template): make the handwritten description placeholder visible

Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>

---------

Co-authored-by: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
---
 .github/PULL_REQUEST_TEMPLATE/general.md | 13 +++----------
 1 file changed, 3 insertions(+), 10 deletions(-)

diff --git a/.github/PULL_REQUEST_TEMPLATE/general.md b/.github/PULL_REQUEST_TEMPLATE/general.md
index 4f1a18e925e..d766897ab3c 100644
--- a/.github/PULL_REQUEST_TEMPLATE/general.md
+++ b/.github/PULL_REQUEST_TEMPLATE/general.md
@@ -6,19 +6,12 @@
 
 ## Handwritten 1-3 sentence description
 
-<!-- The author writes a plain summary in their own words before requesting review.
-     Wrap newly AI-written summary text in the make-me-human-readable tags below, including backticks.
-     The author reviews or rewrites the draft and removes the tags.
-     When updating an existing PR, preserve the author's wording and removed tags.
-     Changes elsewhere in the body do not make an unchanged summary an AI draft again.
-     Add tags again only around newly AI-written replacement summary text, never merely to match this template.
-     This preserves author review across later updates (2026-11-02, #49779).
+<!-- The author writes this in their own words, and it can be left empty. AI agents never write here and leave the
+     placeholder line below as is, and when updating an existing PR they keep whatever the author wrote. Keep this heading
      Say what the PR does for users and why, then anything that keeps it working over time (a sync job, a config someone owns)
      No bullets, tables, or code names here. Everything else goes inside the Details block below -->
 
-`<make-me-human-readable>`
-<blah>
-`</make-me-human-readable>`
+[insert handwritten description here]
 
 <details>
 <summary>Details</summary>