search

get-alex / alex

Catch insensitive, inconsiderate writing
https://alexjs.com
MIT License
4.81k stars 207 forks source link

Add a Further Reading section to the README #306

Closed jenweber closed 3 years ago

jenweber commented 4 years ago

Partially addresses #286

The goal is to help demonstrate why inclusive language is important, and help users to notice the ways in which they need thoughtful human editing, beyond alex, in order to have inclusive content.

I would like to find an article to replace the SheCanCode one, if anyone has ideas. It leans on an example from US politics, which I would like to avoid, when there are so many other things out there.

Feedback, edits, and additions welcome from anyone who is interested in this.

wooorm commented 4 years ago

nice! Iā€™m assuming the CI complains about line length and list bullets though.

harver should perhaps be capitalized?

Iā€™m not sure about an alternative to SheCanCode šŸ¤”

I also recently came across this one, https://incl.ca/disability-language-is-a-nuanced-thing/, which might be something you want to add or I can PR later.

jenweber commented 4 years ago

Hi @wooorm, thanks for the article suggestion. I included it in the list and replaced the SheCanCode article with a link to Textio. I capitalized Harver. I could use your help figuring out what to do with the quotes linting failures. If I swap the regular double quotes " for smart quotes, I get:

Expected `ā€˜` to be used at this level of nesting, not `ā€œ`

If I use ā€˜, I get:

576:61-576:62  warning  Expected `ā€œ` to be used at this level of nesting, not `ā€˜`  quote  retext-quote

Any ideas?

jenweber commented 4 years ago

Sure, I can move this up higher. Thanks for the help with the quote marks.

jenweber commented 3 years ago

Hi, I think maybe this is ready to merge now. Tests are green and I moved it above the FAQ. If you want, I can add similar content to the home page. Just let me know if you have any ideas for how you'd want it to look/read in that context.

wooorm commented 3 years ago

Oh sorry I missed that, perfect!

wooorm commented 3 years ago

This is great, thanks so much @jenweber! šŸ’