Skip to content

Commit 5980f8d

Browse files
committed
Expand on inclusive language and framing in style guide
1 parent d1584cd commit 5980f8d

1 file changed

Lines changed: 21 additions & 2 deletions

File tree

src/content/docs/writing/style.mdx

Lines changed: 21 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -124,7 +124,26 @@ But almost every security step also has a usability cost. We never hide that. Na
124124
"Downsides to using a VPN: You will encounter more CAPTCHAs on websites. Some websites may block VPN access."
125125
</GoodBad>
126126

127-
### 6. Use plain language
127+
### 6. Write for everyone in our movements
128+
129+
Our readers are not a monolith. They include undocumented folks, trans and queer organizers, disabled people, parents, elders (lots of folks joining our movements right now are retirees), and people across different races, classes, and religions. Write as if all of them are in the room — not just the reader you most easily picture.
130+
131+
A few concrete habits:
132+
133+
- **Default to "they/them."** Avoid "he/she," "guys," "manpower," "mankind." When using a hypothetical name, vary it rather than defaulting to one kind of person.
134+
- **Don't assume a single reader profile.** Not every reader is a citizen, has a stable address, uses a newer phone, has reliable internet, or can afford paid tools. Offer free or low-cost paths alongside paid ones.
135+
- **Name when risks hit some people harder.** A phone search, a border stop, or a doxxing incident carries different weight depending on someone's immigration status, disability, or who they're out to. Call it out where it matters instead of writing a generic "activist."
136+
- **Check your own assumptions before publishing.** Ask: who is this written for, and who might it accidentally leave out?
137+
138+
<GoodBad tone="good" type="blockquote">
139+
"If an organizer loses their phone, they should change their passwords right away."
140+
</GoodBad>
141+
142+
<GoodBad tone="good" type="blockquote">
143+
"Biometric unlock (like Face ID) can be legally compelled in more situations than a passcode. This matters especially for undocumented folks and anyone attending high-risk actions."
144+
</GoodBad>
145+
146+
### 7. Use plain language
128147

129148
We use short sentences and everyday language. If a technical term is necessary, we define it immediately, in context. We use contractions ("don't," "won't," "you'll") and parenthetical asides ("yes, we hate Amazon too"). Conversational but not sloppy.
130149

@@ -168,7 +187,7 @@ We choose the clearest term as our default — "people search sites" instead of
168187
- Condescending framings ("it's easy," "simply do X," "just follow these steps")
169188
- Corporate security language ("implement," "deploy," "leverage," "utilize")
170189
- Passive voice when describing threats
171-
- Gendered language
190+
- Gendered language, or assumptions that don't apply to all readers (citizenship status, income, tech access, ability — see principle 6)
172191

173192

174193
## Content Standards

0 commit comments

Comments
 (0)