PR Comments with a Purpose

pr-comments.md

This is a set of ‘statuses’ that pull request comments must be marked with to help explain intent.

• Change Requested: This must be fixed before merge.
• Suggested Change: Not blocking, but I suggest we do it this way.
• Potential Alternative: Presenting an alternative approach in order to invite discussion.
• Nice to have: Would be great to fix eventually.
• Personal Preference: I would do this, but you don’t have to.
• Question: Point of clarification on the approach
• For My Understanding A question to help me understand

^{Modified from Scaling Square Register on objc.io}

setup.md

Creating Saved Replies

Navigate to your GitHub Saved Replies and add new saved replies with the following templates. You're welcome to use this gist or fork it and use your own.

Example

---

PR: Change Requested

**Change Requested** (this blocker must be fixed before merge) <sup>[What's this?](https://gist.github.com/mtucker/96794274f9d8dad484c4cfa3593063ef)</sup>

---

PR: Potential Alternative

**Potential Alternative** <sup>[What's this?](https://gist.github.com/mtucker/96794274f9d8dad484c4cfa3593063ef)</sup>

---

PR: Suggested Change

**Suggested Change** <sup>[What's this?](https://gist.github.com/mtucker/96794274f9d8dad484c4cfa3593063ef)</sup>

---

PR: Nice to Have

**Nice to Have** <sup>[What's this?](https://gist.github.com/mtucker/96794274f9d8dad484c4cfa3593063ef)</sup>

---

PR: Personal Preference

**Personal Preference** <sup>[What's this?](https://gist.github.com/mtucker/96794274f9d8dad484c4cfa3593063ef)</sup>

---

PR: Question

**Question** <sup>[What's this?](https://gist.github.com/mtucker/96794274f9d8dad484c4cfa3593063ef)</sup>

---

PR: For My Understanding

**For My Understanding** <sup>[What's this?](https://gist.github.com/mtucker/96794274f9d8dad484c4cfa3593063ef)</sup>

Using Saved Replies

When creating an inline comment in a PR, click the button and select your saved reply from the popover.

Step	Example
Click the Reply button
Select your reply to autofill
Enter your comment