Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Request: Make the project more inclusive and accessible #47

Open
Tracked by #51
oood opened this issue Mar 3, 2023 · 9 comments
Open
Tracked by #51

Request: Make the project more inclusive and accessible #47

oood opened this issue Mar 3, 2023 · 9 comments
Milestone

Comments

@oood
Copy link
Member

oood commented Mar 3, 2023

Requests:

  • Do not use master as the default branch name anymore.

  • Make documentation easier for colorblind (CVD) readers.

Rationale:

  • Since 2020, GitHub has changed the default branch of the new repository from the original master to the less offensive main. This is part of the Software Freedom Conservancy's advocacy for a more inclusive programming environment.

  • According to the data, about 8% of men and 0.5% of women have difficulty distinguishing between red and green colors.

Suggestions:

  • Change to the less offensive main, or another name.

  • Use text to explain how recommended an abbreviation is, or other emojis 👍/👌/👎.

This issue is a fork of a previous thread (#41), you may be interested in reading the previous discussion history.

@T1xx1
Copy link
Member

T1xx1 commented Mar 3, 2023

  • Use text to explain how recommended an abbreviation is, or other emojis 👍/👌/👎.

Great 👍

@oood
Copy link
Member Author

oood commented Mar 3, 2023

Great 👍

Not sure if it can be considered as the final solution, since a single color hand lacks inclusivity. that's why I prefer to use a simple text as an explanation of the degree of recommendation.

@kisvegabor
Copy link
Member

kisvegabor commented Mar 4, 2023

Thank you for bringing up these points. I think 🟢, 🟡 and 🔴 are very intuitive for ~95% of people. So I think we should keep these in some form.

What about this?

  • 🟢 abbr1
  • 🟡 abbr1
  • 🔴 abbr1

Although italic and normal are hard to distinguish, but yellow is usually not subject of color blindness.

What do you think?

@T1xx1
Copy link
Member

T1xx1 commented Mar 4, 2023

Thank you for bringing up these points. I think 🟢, 🟡 and 🔴 are very intuitive for ~95% of people. So I think we should keep these in some form.

What about this?

  • 🟢 abbr1
  • 🟡 abbr1
  • 🔴 abbr1

Although italic and normal are hard to distinguish, but yellow is usually not subject of color blindness.

What do you think?

Also this method seems good

@oood
Copy link
Member Author

oood commented Mar 4, 2023

Thank you for bringing up these points. I think 🟢, 🟡 and 🔴 are very intuitive for ~95% of people. So I think we should keep these in some form.

In fact, Github's colors are carefully designed, it uses green and purple to mark open and closed issues.

Green 🟢 and red🔴 can be hard to tell apart for some, but purple 🟣 is a lot better.

Red🔴 and blue🔵 are also fine for most colorblind readers.

And, if you're going to develop it into a dictionary, then I think there can be multiple formats out there.

We don't have to tangle here.

There can be a raw data there, and then use GitHub Actions to automatically generate dictionaries in various formats. like json, and red and green. we only need to maintain a basic raw data.

@oood
Copy link
Member Author

oood commented Mar 4, 2023

So, I think we don't really need to care too much about the color of the circle, we just need to create a raw database, then maintain the database, and use scripts to automatically generate readme files.

@kisvegabor
Copy link
Member

I've just suggested the same thing here 🙂

@philipeachille
Copy link
Member

Green 🟢 and red🔴 can be hard to tell apart for some, but purple 🟣 is a lot better.

I am happy to switch red to purple, if it increases readability for the last 5% of humans. It is also a nice purple and maybe even less of a "hard no".

@oood
Copy link
Member Author

oood commented Mar 5, 2023

I am happy to switch red to purple, if it increases readability for the last 5% of humans. It is also a nice purple and maybe even less of a "hard no".

Yes, glad you can think so.

But now making the database format is prioritized over this issue, because once we update the abbreviations in the database, then, we can create lists in various formats, suitable for all people and all machines.

Please discuss the format of the database here: #48

@T1xx1 T1xx1 added this to the Dictionary project milestone Mar 7, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

4 participants