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
----------------------------------------