Skip to content

Commit c6b20b3

Browse files
committed
Avoid weasel words/justification filler phrases
1 parent be9343c commit c6b20b3

File tree

1 file changed

+6
-0
lines changed

1 file changed

+6
-0
lines changed

code-review/README.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -27,6 +27,10 @@ Watch a presentation that covers this material from [Derek Prior at RailsConf 20
2727
- **Avoid diminishing words**
2828
- "simply", "simple", "just"
2929

30+
- **Avoid [weasel words]/[justification filler phrases]**
31+
- "Researchers say that", "it's a best practice".
32+
- Be cliear and explain the tradeoffs and impacts of a particular solution.
33+
3034
- **Be explicit**
3135
- Remember people don't always understand your intentions online.
3236

@@ -133,3 +137,5 @@ This helps us have more meaningful conversations on PRs rather than debating per
133137
[challenging to convey emotion and intention online]: https://thoughtbot.com/blog/empathy-online
134138
[using labels]: https://conventionalcomments.org
135139
[standard]: https://github.com/testdouble/standard
140+
[weasel words]: https://en.wikipedia.org/wiki/Weasel_word
141+
[justification filler phrases]: https://serce.me/posts/2025-05-19-justification-filler-phrases

0 commit comments

Comments
 (0)