rust-lang / rust-lang/rustc-dev-guide
Clarify "call site hierarchy" in macro
Nobody has claimed this yet.
- Dominant language
- HTML
- Stars
- 1.9k
- Forks
- 613
- Avg merge
- 17h 24m
- Merged PRs (30d)
- 39
Description
I'd appreciate if you could clarify, in https://rustc-dev-guide.rust-lang.org/macro-expansion.html , the part about call site hierarchy.
Giving an example with a non-trivial hierarchy may suffices. But right now, I admit I've no idea what it means. And why this is compared to the first hierarchy.
It's even stranger, because the text mentions the hierarchy of macro invocation, but it considers the hierarchy of baz which is not a macro
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
Read the call site hierarchy section in macro-expansion.html, then compare its explanation with the first hierarchy and the example involving baz. Clarify what the hierarchy means, why the comparison is made, and add a non-trivial hierarchy example so the page’s description is understandable.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- rust
- Domain
- compilers, documentation
- Issue type
- Documentation
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 55/100