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

Comment syntax and accessibility #120

Closed
ghost opened this issue Mar 22, 2018 · 2 comments
Closed

Comment syntax and accessibility #120

ghost opened this issue Mar 22, 2018 · 2 comments

Comments

@ghost
Copy link

ghost commented Mar 22, 2018

Hi there!

In the wake of a discussion following accessibility, it was pointed out that the comment syntax for blind programmers has a far better user experience when using block comments (rust-lang/rfcs#1373 (comment)), but the style goes against that.

Given the purely stylistic nature of it, shouldn't accessibility be prioritised to offer a better experience to disabled people?

@solson
Copy link
Member

solson commented Mar 30, 2018

This was previously considered, including with the input of author of the comment you linked to, at #17. I'm not sure that we need to rehash it again, so I'm closing this, but feel free to reopen (or reply on #17, I suppose) if you have a fresh take on it.

A quick summary of what I can recall about the thread:

  • Line comments are default, in line with the preference of the vast majority of the community
  • However, block comments are still available as an option
  • It may be more accessible to change the default, but it's out of scope for the style team to pick defaults counter to the established norm and try to convince everyone to accept it.
  • @camlorn noted in particular that while line comments are an irritation, they were not a barrier to being productive as a blind programmer.

@solson solson closed this as completed Mar 30, 2018
@skade
Copy link

skade commented Apr 16, 2018

I was recently discussing this with a blind community member from Germany, who absolutely loves the "///" standard, as they are using a refreshable braille display. These are standard in Europe, but not so much in the US, where screenreading is preferred, as far as I understood.

When using these displays, you are quickly going line-by-line, with tactile display. The "///" default is much better in this case then block comments, as you immediately get context.

So, a better way to interact with the problem is see which methods of accessibility we support better or worse.

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

2 participants