rust-lang / rust-lang/reference
Clumsy language in "Follow-set Ambiguity Restrictions" of Macros by example
Nobody has claimed this yet.
- Dominant language
- Rust
- Stars
- 1.6k
- Forks
- 607
- PR merge metrics
- PR metrics pending
Description
As it stands the text reads:
In particular, in addition to the rule about ambiguous expansions, a nonterminal matched by a metavariable must be followed by a token which has been decided can be safely used after that kind of match.
"which has been decided can be safely used" sounds awkward to me, the general meaning is apparent, but there must be a nicer option so I think it should be improved and this Issue is about how to do that.
Maybe we can introduce some agency. "which the Rust Language Team has decided can be safely used"? (but we should make sure that if a specific person or group is named, that's the right one)
Or maybe deliberately don't, "which it has been decided can be safely used"? Leaving it to an interested reader to investigate how this was decided and what processes control this decision.
Contributor guide
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 in the "Follow-set Ambiguity Restrictions" section of "Macros by example" and review the quoted sentence alongside the wording alternatives in the issue. Done means replacing the awkward phrasing with an agreed, accurate sentence without changing its meaning.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- rust
- Domain
- documentation
- Issue type
- Documentation
- Difficulty
- 1/5
- Estimated time
- Under an hour
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 48/100