rust-lang / rust-lang/reference

Rename "Value expressions and place expressions" section to "Expression categories"

Open
#972 4 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

A-expressions Language Cleanup
Dominant language
Rust
Stars
1.6k
Forks
607
PR merge metrics
PR metrics pending

Description

C++ calls them value categories. Since we call one "value expression", I'd like to avoid that term and instead call them a category of some kind. Since the distinction is about what kind of thing the expression evaluates to, I figured "evaluation category" would be the best term.

Having this term would also let me say parenthesized expressions are of the same evaluation category as their enclosed operand.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by locating the Reference section named “Value expressions and place expressions” and review its terminology and surrounding references. Check the issue discussion before deciding between “Expression categories” and “evaluation category”; done means the chosen terminology is applied consistently wherever the section and its concepts are described.

Written by the indexing model from the issue text.

Assessment

Tech stack
rust
Domain
documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.