summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authormo khan <mo@mokhan.ca>2022-06-18 12:04:37 -0600
committermo khan <mo@mokhan.ca>2022-06-18 12:04:37 -0600
commit21275e371e2bb44dd1cad567cc6cc3163b196d44 (patch)
treea92eb75f10498fa6fcf0942a013897d5ae9fa2d8
parent32db39f880161925e4ef024a4cc1b3a91dd4771e (diff)
docs: add notes on issue/pr feedback
-rw-r--r--learn/humans/README.md9
1 files changed, 9 insertions, 0 deletions
diff --git a/learn/humans/README.md b/learn/humans/README.md
index e263a4e..78a2fbc 100644
--- a/learn/humans/README.md
+++ b/learn/humans/README.md
@@ -94,6 +94,15 @@ Prefer:
* xxx over _retard_. # insensitive towards kids with delayed development.
* xxx over _lame_. # insensitive towards kids with physical disability.
+### Issue/Pull Request Feedback
+
+Ask don't tell. Ask questions and be curious.
+Cut down on the back and forth by clearly stating your assumptions.
+The person reading your comment cannot read your mind.
+Use [conventional comments](https://conventionalcomments.org/) to guide you.
+Ensure readers understand which one of your comments must be addressed and which
+ones are non-blocking.
+
## Decisions
How do we make decisions? TODO::