Replacing "might" with "can" obscures the distinction of possiblity and risk
Nobody has claimed this yet.
- Dominant language
- TeX
- Stars
- 221
- Forks
- 813
- Avg merge
- 16h 4m
- Merged PRs (30d)
- 36
Description
This is a tracking issue for a discussion that arose from the "could"/"might" wording changes.
We initially proposed replacing "might" with "can" in several cases, but this has a different nuance that might not be desirable.
As @zygoloid puts it:
I prefer the nuance of "might" here, as we're talking about a thing that might unfortunately happen to an unsuspecting programmer, not something they can choose to do.
I wonder if that's a good barometer in general: using "can" to discuss risks seems like it has the wrong nuance.
We have multiple instances where "might" is used to call out a risk, not a possiblity.
Additional feedback on "might" => "can" changes:
This note to me sounds like it's directed at the programmer, not the implementation, and the change from "might" to "can" reverses that. So this is at least a change in nuance.
[Re "
fmight throw" vs "fcan throw" or "it is possible forfto throw":] This is stating something as fact that is not known to be true -- we don't know whether it's possible forfto throw because we haven't seen its definition. (There's a surprisingly subtle difference between "X might Y" and "it is possible for X to Y" here.)
See the discussions in #4384 for context.
I expect that we will want to rephrase the offending phrases more widely than by just replacing one word with another.
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start with the discussion in #4384 and review this issue's examples of “might” versus “can.” Locate the wider set of affected wording in the draft, then use the resolved discussion to determine which phrases need rewording and what constitutes an accepted distinction between risk and possibility.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- tex
- Domain
- documentation
- Issue type
- Documentation
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Stale
- Clarity
- Needs clarification
- Newbie friendliness
- 25/100