Imagine that you published a big open source project and many people are currently changing your code or updating the project documents.
what if someone accidently write something race related , gender favoring , polarizing and etc... π
we have a tool called alex !
According to what is written in the documentation of this tool:
Whether your own or someone elseβs writing, alex helps you find gender favoring, polarizing, race related, or other unequal phrasing in text.
Set up Alex in our project
in order to use alex inside our project , first we need to install its package.
it will be a good practice if you install alex as a dev-dependency
or you can just install it globally in your system.
npm i -D alex
Alex reads plain text, HTML, MDX, or markdown as input.
One of its uses is to scan all project documents for any literary issues.
Letβs assume that all our documents are written in Markdown format, so we instruct Alex to check all files with a .md extension
In our package.json file, we can create a script like:
{
"scripts": {
"test-doc" : "npx alex *.md"
}
After that, I create a file called policy.md as an example document:
## the boogeyman walked to class
if you run the test-doc command, you will probably get this result:
> test-doc
> npx alex *.md
policy.md
1:8-1:17 warning `boogeyman` may be insensitive, use `boogeymonster` instead boogeyman-boogeywoman retext-equality
βΌ 1 warning
You can use this command together with tools such as Husky ** and **lint-staged to run the process of checking your files automatically. π€
What are your thoughts on this tool, and how crucial is compliance with this matter for software projects? π§π€
Top comments (34)
I have no words. This is completely ridiculous
true π€£π€π»
Also, this kind of thing (whether a document is not 'inclusive', or is 'offensive') should be determined/resolved by the normal process of PRs and review/discussion - not arbitrary decision making by a dumb model that has no idea or understanding about context, sarcasm, intent, etc.
This really feels like a solution looking for a problem.
Might be useful for checking and refactoring old documents, but I agree that you should not just treat the this tools as an end all solution.
thank you for your feedback π€
What is this abormination?!!! Why would anyone spending their time to create such a tasteless tool like this? What a waste of time!
π
People don't understand. π
I can understand, though. π
Is this a late April Fools?
Maybe, who knows! ππ
Humanity is doomed.
However, it can still be viewed as a fun tool. π
Lol good luck writing "merged changes to 'master'"
π«‘
Seems like a great little tool! Thank you for bringing it to my attention :)
Thank you for your positive feedback! π€
Nice little joke you got there. Probably some conservative who wants promote the anti woke movement. They'll follow up with a post against wokeness on Twitter or Reddit
Unnecessary.
thank you for your feedback sir π«‘π
What the hell has happened to the freaking world? What's next? Enforcing git branch names?!?!! Oh wait ..
I feel offended by this tool π€£
Wow the levels that we are reaching now. We are doomed π
I am slowly thinking that it would have been better if I had not used the example in the documentation of this tool π΅π·
The situation is getting worse π€£π€£
So this library has a list of keywords and loops through the text to return the ones in the list?
But somehow, is very importantΒΏ
Yet another example of how to build a cluttered build pipeline.
π
I can see value the value in this tool...
But the example is purely engagement-bait isn't it?
I don't blame you. The number of comments speaks for itself, mine included. π€·ββοΈ
I used the example of the documentation in here But I am pleased to see that it is driving engagement. π€ππ
The example used is crazy. The tool would be helpful if it checked specifically for slurs and derogatory language.
Iβm not sure but I think it detects slurs too
Lol....What is available in these days is unbelievable.
I'm always surprised π€£
If I say that the idea of ββthis project has been around for a long time and it has only become more complete, it might spoil it more ππ€£