Merge pull request #15938 from civicrm/5.20

[civicrm-core.git] / .github / PULL_REQUEST_TEMPLATE.md

diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md
index 85e7f8f59d2d9d1434aa723b4f22a59f1c7a562f..e9760193f69b4abba280c3ea6f1910729b515e12 100644 (file)
--- a/.github/PULL_REQUEST_TEMPLATE.md
+++ b/.github/PULL_REQUEST_TEMPLATE.md
@@ -1,18 +1,20 @@
 Overview
 ----------------------------------------
-_A brief description of the pull request. Try to keep it non-technical._
+_A brief description of the pull request. Keep technical jargon to a minimum. Hyperlink relevant discussions._
 
 Before
 ----------------------------------------
-_The current status. Please provide screenshots or gifs ([LICEcap](http://www.cockos.com/licecap/), [SilentCast](https://github.com/colinkeenan/silentcast)) where appropriate._
+_What is the old user-interface or technical-contract (as appropriate)?_
+_For optimal clarity, include a concrete example such as a screenshot, GIF ([LICEcap](http://www.cockos.com/licecap/), [SilentCast](https://github.com/colinkeenan/silentcast)), or code-snippet._
 
 After
 ----------------------------------------
-_What has been changed. Please provide screenshots or gifs ([LICEcap](http://www.cockos.com/licecap/), [SilentCast](https://github.com/colinkeenan/silentcast)) where appropriate._
+_What changed? What is new old user-interface or technical-contract?_
+_For optimal clarity, include a concrete example such as a screenshot, GIF ([LICEcap](http://www.cockos.com/licecap/), [SilentCast](https://github.com/colinkeenan/silentcast)), or code-snippet._
 
 Technical Details
 ----------------------------------------
-_If the PR introduces noteworthy technical changes, please describe them here. Provide code snippets if necessary_
+_If the PR involves technical details/changes/considerations which would not be manifest to a casual developer skimming the above sections, please describe the details here._
 
 Comments
 ----------------------------------------