-
Notifications
You must be signed in to change notification settings - Fork 195
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
Consider using less morally-loaded language in hints. #1584
Comments
I'm happy either way. No intention to make a moral judgement. Maybe even simplify further to "Perhaps remove it." ? Only concern is breaking people who match on it with regexes or what not, but hopefully that's fairly rare. |
I'm all for being more sensitive and non-hurtful, but I believe changing "should" to "you may" or "you could" is changing the semantics of the sentence from a "this might be an improvement" to "it's unclear whether this is better, but you could do it". In the first place, I believe that Perhaps I'm just misunderstanding your grievance, though. In the sentence
what makes you feel that "Perhaps you should remove it." implies some personal fault in the person reading the message? I feel that language is fairly gently phrased, and it seems like the same language people use in code review all the time (IME), to make suggestions to other people, with no intent (or effect, I assume) of being hurtful. Or to put it differently, how would you phrase a suggestion to change something that another person implemented, in the case where that change would be a justifiably objective improvement? |
That's the entire point. Using words like "better" when it comes to a subject that isn't a moral one is dangerous. Code isn't better or worse either. It's more effective/efficient/easier to maintain/...
There are plenty of cases in which
To be clear; I don't intend to suggest that this language was used with harmful intent.
"This fold does not run in constant stack space, see this comment. I think you will want to use @ndmitchell: I think the regex use-case can safely be ignored because there is a |
I know I stand a good chance of being ridiculed for this, so please hear me out, but feel free to ignore this issue entirely.
Hints are sometimes phrased as "Perhaps you should remove it." which seems to imply that "a person who does remove it is a better person".
hlint/src/Idea.hs
Line 82 in 6898b43
This issue exists just to suggest replacing "should" by "could".
Or even: "You may be able to remove it."
The text was updated successfully, but these errors were encountered: