Skip to content

Commit f9bcc22

Browse files
authored
Add a Further Reading section to the README
Related to: GH-286 Closes GH-306. Reviewed-by: Titus Wormer <[email protected]>
1 parent 3474dd9 commit f9bcc22

File tree

1 file changed

+42
-0
lines changed

1 file changed

+42
-0
lines changed

readme.md

Lines changed: 42 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -68,6 +68,7 @@ Or you can follow this step-by-step tutorial:
6868
* [This is stupid!](#this-is-stupid)
6969
* [alex didn’t check “X”!](#alex-didnt-check-x)
7070
* [Why is this named alex?](#why-is-this-named-alex)
71+
* [Further reading](#further-reading)
7172
* [Contribute](#contribute)
7273
* [Origin story](#origin-story)
7374
* [Acknowledgments](#acknowledgments)
@@ -557,6 +558,47 @@ It’s a nice unisex name, it was free on npm, I like it! :smile:
557558

558559
<!--lint enable no-heading-punctuation-->
559560

561+
## Further reading
562+
563+
No automated tool can replace studying inclusive communication and listening to
564+
the lived experiences of others.
565+
An error from `alex` can be an invitation to learn more.
566+
These resources are a launch point for deepening your own understanding and
567+
editorial skills beyond what `alex` can offer:
568+
569+
* The [18F Content Guide](https://content-guide.18f.gov/our-style/inclusive-language/)
570+
has a helpful list of links to other inclusive language guides used in
571+
journalism and academic writing.
572+
* The [Conscious Style Guide](https://consciousstyleguide.com/articles/) has
573+
articles on many nuanced topics of language. For example, the terms race
574+
and ethnicity mean different things, and choosing the right word is up to
575+
you.
576+
Likewise, a sentence that overgeneralizes about a group of people
577+
(e.g. “Developers love to code all day”) may not be noticed by `alex`, but
578+
it is not inclusive. A good human editor can step up to the challenge and
579+
find a better way to phrase things.
580+
* Sometimes, the only way to know what is inclusive is to ask.
581+
In [Disability is a nuanced thing](https://incl.ca/disability-language-is-a-nuanced-thing/),
582+
Nicolas Steenhout writes about how person-first language, such as
583+
“a person with a disability,” is not always the right choice.
584+
* Language is always evolving. A term that is neutral one year ago can be
585+
problematic today. Projects like the
586+
[Self-Defined Dictionary](https://github.com/selfdefined/web-app) aim to
587+
collect the words that we use to define ourselves and others, and connect
588+
them with the history and some helpful advice.
589+
* Unconsious bias is present in daily decisions and conversations and can show
590+
up in writing.
591+
[Textio](https://textio.com/blog/4-overlooked-types-of-bias-in-business-writing/27521593662)
592+
593+
offers some examples of how descriptive adjective choice and tone can push
594+
some people away, and how regional language differences can cause confusion.
595+
* Using complex sentences and uncommon vocabulary can lead to less inclusive
596+
content. This is described as literacy exclusion in
597+
[this article by Harver](https://harver.com/blog/inclusive-job-descriptions/).
598+
This is critical to be aware of if your content has a global audience,
599+
where a reader’s strongest language may not be the language you are writing
600+
in.
601+
560602
## Contribute
561603

562604
See [`contributing.md`][contributing] in [`get-alex/.github`][health] for ways

0 commit comments

Comments
 (0)