Skip to content

Commit 052acf7

Browse files
committed
reshuffle dos and donts
1 parent 5c85aca commit 052acf7

File tree

1 file changed

+4
-5
lines changed

1 file changed

+4
-5
lines changed

BLOG_STYLE_GUIDE.md

Lines changed: 4 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -67,16 +67,15 @@ This list is non-exhaustive. If there is something you would like to see on the
6767
## ✅ Do
6868

6969
- Cite sources if you reference third-party tools or documentation.
70-
- Avoid assumptions: don’t assume the reader knows your stack.
7170
- Use inclusive language: prefer "you/the user" over gendered or assumptive terms.
7271
- Use present tense.
7372

7473
## ❌ Don't
7574

76-
- Overuse of metaphors. Use them sparingly to aid understanding.
77-
- Outdated examples or deprecated syntax.
78-
- Avoid passive voice when possible.
79-
- Avoid future tense.
75+
- Don’t assume the reader knows your stack.
76+
- Don't overuse of metaphors. Use them sparingly to aid understanding.
77+
- Don't overuse passive voice. Active voice often brings more clarity.
78+
- Don't overuse future tense. The present tense often brings more clarity.
8079

8180
---
8281

0 commit comments

Comments
 (0)