- Limitare il titolo a 5-6 parole massime;
- Scegliere un titolo auto-esplicativo, rappresentativo e rispettare le regole di scrittura;
- Utilizzare il "tu" anziché il "voi" per creare empatia con il lettore;
- Limitarsi a una gerarchia di sezioni fino al terzo livello;
- Utilizzare la sezione H1 solo per il titolo del capitolo.
- Dare visibilità a un genere neutrale o oscurare entrambi i generi per inclusività;
- Utilizzare formulazioni neutre o riformulare con "chi" per evitare riferimenti di genere;
- Utilizzare nomi collettivi o parole inglesi per evitare specificazioni di genere;
- Utilizzare forme impersonali o del passivo per evitare forme personali.
| Invece di... | Meglio usare... |
|---|---|
| L'uomo/la donna | Le persone |
| Lo sviluppatore/la sviluppatrice | Chi sviluppa, chi programma, la professione di developer |
| Il recruiter | Chi fa recruitement, la figura del/la recruiter |
| Il sistemista | Chi lavora come sistemista |
| L'ingegno dell'uomo | L'ingegno umano |
| Un developer | Un/a developer |
| Caro lettore | A te che leggi/Tu che leggi |
| Essere un dev | Indossare i panni da dev |
| Tutti gli informatici | Tutte le persone che lavorano nell'informatica/nel settore IT |
| Blacklist | Ignorelist |
| Whitelist | Allowlist |
Puoi consultare le linee guida complete nel file GUIDELINES.md.