rust-lang/rustc-dev-guide

View on GitHub

A guide to how rustc works and how to contribute to it.

Stars: 1.9k
Forks: 613
Open beginner issues: 3
Indexed issues: 139
Avg merge: 17h 24m
Merged PRs (30d): 39

Dominant language: HTML
License: Apache-2.0
Last GitHub push: Sep 19, 2026
Latest indexed: Sep 19, 2026
Contributing guide: No contributing guide
Code of conduct: Code of conduct
Beginner labels: No beginner labels indexed

Beginner friendly Everything

Open All

139 open issues indexed

Typo in docs Open

needs-triage

Difficulty 1/5 Under an hour Newbie friendliness 82/100

rust-lang/rustc-dev-guide#3017 · 1 reaction · Opened Sep 15, 2026
[automation] Dead links found Open

A-linkcheck C-broken-links C-CI needs-triage

Difficulty 2/5 1-3 hours Newbie friendliness 68/100

rust-lang/rustc-dev-guide#3010 · 27 comments · Opened Sep 10, 2026
Date Reference Triage for 2026-09 Open

C-date-reference-triage E-easy E-help-wanted needs-triage

Difficulty 4/5 3-5 days Newbie friendliness 62/100

rust-lang/rustc-dev-guide#2997 · 1 comment · Opened Sep 1, 2026
inline `tests/mir-opt` docs into the dev-guide Open

needs-triage

Difficulty 2/5 1-3 hours Newbie friendliness 78/100

rust-lang/rustc-dev-guide#2974 · 1 reaction · Opened Aug 17, 2026
Add recommendations for distro usage Open

A-build needs-triage

Difficulty 4/5 3-5 days Newbie friendliness 45/100

rust-lang/rustc-dev-guide#2917 · 3 comments · Opened Jul 6, 2026
[Suggestion] Add how to use RustRover for Rust compiler development Open

needs-triage

Difficulty 2/5 1-3 hours Newbie friendliness 70/100

rust-lang/rustc-dev-guide#2858 · Opened Apr 30, 2026
Type System Documentation Overhaul Open

C-tracking-issue T-types

rust-lang/rustc-dev-guide#2663 · 3 comments · 2 reactions · 1 assignee · Opened Nov 29, 2025
Document that MacOS aarch64 is not available for debugging with GDB. Open

needs-triage

Difficulty 2/5 1-3 hours Newbie friendliness 48/100

rust-lang/rustc-dev-guide#2626 · 1 comment · Opened Nov 3, 2025
rustdoc: Restructure all rustdoc-related chapters Open

C-cleanup C-enhancement T-rustdoc

Difficulty 5/5 Over a week Newbie friendliness 25/100

rust-lang/rustc-dev-guide#2459 · Opened Jun 7, 2025
add section about how rustdoc uses static analysis Open

C-enhancement T-rustdoc

Difficulty 2/5 1-2 days Newbie friendliness 45/100

rust-lang/rustc-dev-guide#2449 · 1 comment · 1 reaction · Opened Jun 2, 2025
Better contributing docs for rustc-dev-guide itself Open

A-contributor-onboarding A-meta C-enhancement WG-rustc-dev-guide

Difficulty 3/5 1-2 days Newbie friendliness 35/100

rust-lang/rustc-dev-guide#2448 · Opened Jun 2, 2025
Document how to figure out which rust-lang/rust CI job run what test suites against which host/targets Open

A-CI A-test-suite C-enhancement T-bootstrap T-compiler T-infra

Difficulty 4/5 3-5 days Newbie friendliness 25/100

rust-lang/rustc-dev-guide#2442 · Opened Jun 2, 2025
set up live previews for prs Open

A-contributor-devex C-enhancement T-infra WG-rustc-dev-guide

Difficulty 4/5 3-5 days Newbie friendliness 35/100

rust-lang/rustc-dev-guide#2423 · 1 comment · Opened May 28, 2025
explain how rustdoc uses eslint Open

A-test-suite C-enhancement T-rustdoc

Difficulty 1/5 Under an hour Newbie friendliness 45/100

rust-lang/rustc-dev-guide#2364 · Opened Apr 29, 2025
description of rustdoc test suites is scattered Open

A-test-suite I-confusing I-terse T-rustdoc

Difficulty 2/5 1-3 hours Newbie friendliness 45/100

rust-lang/rustc-dev-guide#2260 · Opened Feb 24, 2025
Bug: Book build fails on Windows Open

C-bug O-windows WG-rustc-dev-guide

Difficulty 3/5 1-2 days Newbie friendliness 35/100

rust-lang/rustc-dev-guide#2204 · 4 comments · Opened Jan 10, 2025
Rework the test directives page Open

A-compiletest A-test-suite I-confusing I-outdated T-bootstrap T-compiler

Difficulty 4/5 3-5 days Newbie friendliness 35/100

rust-lang/rustc-dev-guide#2187 · Opened Jan 2, 2025
Talk about the `async` machinery, the key concepts, analysis, representations, etc. Open

A-async A-HIR A-MIR A-THIR A-types C-enhancement I-terse T-compiler WG-async

Difficulty 5/5 Over a week Newbie friendliness 20/100

rust-lang/rustc-dev-guide#2144 · Opened Nov 21, 2024
Flesh out HIR chapter to go more in depth about how hir is structured and all its IDs Open

A-HIR C-enhancement E-medium I-terse T-compiler

Difficulty 4/5 3-5 days Newbie friendliness 35/100

rust-lang/rustc-dev-guide#2143 · Opened Nov 21, 2024
Tracking issue for high-level compiler overview rework Open

A-compiler-architecture C-enhancement C-tracking-issue T-compiler

Difficulty 5/5 Over a week Newbie friendliness 25/100

rust-lang/rustc-dev-guide#2116 · 1 comment · Opened Nov 2, 2024
mention S-tracking-needs-summary under "what should i work on" Open

A-contributor-onboarding A-meta C-discussion

Difficulty 2/5 1-3 hours Newbie friendliness 35/100

rust-lang/rustc-dev-guide#2053 · 3 comments · Opened Sep 3, 2024
It's not clear what's worthy of relnotes Open

C-discussion T-compiler T-release

Difficulty 3/5 1-2 days Newbie friendliness 42/100

rust-lang/rustc-dev-guide#2014 · 1 comment · 1 reaction · Opened Jul 14, 2024
move lcnrs leak check fcp to dev guide Open

C-enhancement T-compiler T-types

rust-lang/rustc-dev-guide#2003 · 1 comment · 1 reaction · 1 assignee · Opened Jun 24, 2024
Guide answers "what" but not "why" and "how" for codegen tests Open

A-codegen A-FileCheck A-test-suite C-enhancement E-hard T-compiler

Difficulty 3/5 1-2 days Newbie friendliness 48/100

rust-lang/rustc-dev-guide#1965 · Opened Apr 23, 2024
HIR documentation is outdated Open

A-HIR E-medium I-outdated T-compiler

Difficulty 4/5 3-5 days Newbie friendliness 38/100

rust-lang/rustc-dev-guide#1896 · 1 reaction · Opened Feb 24, 2024
Clarify "call site hierarchy" in macro Open

A-macros E-hard I-confusing T-compiler

Difficulty 2/5 1-3 hours Newbie friendliness 55/100

rust-lang/rustc-dev-guide#1874 · Opened Jan 28, 2024
In macro expansion section, explains why import and collections must be redone Open

A-macros E-hard I-terse T-compiler

Difficulty 3/5 1-2 days Newbie friendliness 45/100

rust-lang/rustc-dev-guide#1873 · Opened Jan 28, 2024
Not clear sentence "Eager expansion generally performs a subset of the things that lazy (normal) expansion does." Open

A-macros E-hard I-confusing T-compiler

Difficulty 3/5 1-2 days Newbie friendliness 35/100

rust-lang/rustc-dev-guide#1871 · Opened Jan 28, 2024
Clarify why Salsa is mentioned Open

A-incr-comp A-query-system E-medium I-confusing T-compiler

Difficulty 2/5 1-3 hours Newbie friendliness 35/100

rust-lang/rustc-dev-guide#1867 · 2 comments · Opened Jan 28, 2024
In Compiler Architecture section, state explicitly you assume the compiler do not change between build Open

A-compiler-architecture A-incr-comp A-query-system E-medium I-confusing T-compiler

Difficulty 2/5 1-3 hours Newbie friendliness 52/100

rust-lang/rustc-dev-guide#1860 · Opened Jan 27, 2024
explain generalization when talking about type inference Open

A-inference E-hard I-terse T-types

rust-lang/rustc-dev-guide#1820 · 1 reaction · 1 assignee · Opened Nov 3, 2023
Appendix B: Glossary, Update Open

A-glossary C-enhancement E-medium I-terse

Difficulty 2/5 1-3 hours Newbie friendliness 45/100

rust-lang/rustc-dev-guide#1796 · 1 reaction · Opened Sep 18, 2023
Example of using rustc_interface to generate the HIR for a file referencing dependent crates? Open

A-custom-driver C-discussion E-hard I-terse T-compiler

Difficulty 4/5 3-5 days Newbie friendliness 38/100

rust-lang/rustc-dev-guide#1720 · 3 comments · 1 reaction · Opened Jul 3, 2023
Improve compiler top-level description in rustc-dev guide Open

A-compiler-architecture E-hard T-compiler

Difficulty 2/5 1-3 hours Newbie friendliness 55/100

rust-lang/rustc-dev-guide#1691 · 8 reactions · Opened Jun 3, 2023
Document how to find the nightly version that a beta/stable was branched from Open

A-git C-enhancement E-hard T-release

Difficulty 3/5 1-2 days Newbie friendliness 45/100

rust-lang/rustc-dev-guide#1676 · Opened Apr 19, 2023
Improve contributing text about subtrees Open

A-meta E-medium I-confusing T-bootstrap T-compiler

Difficulty 2/5 1-3 hours Newbie friendliness 42/100

rust-lang/rustc-dev-guide#1672 · Opened Apr 13, 2023
Integrate Jake's dataflow hackmd into the existing chapter Open

A-dataflow A-mir-opt E-help-wanted E-medium E-needs-writeup T-compiler

Difficulty 3/5 1-2 days Newbie friendliness 45/100

rust-lang/rustc-dev-guide#1658 · 1 reaction · Opened Apr 3, 2023
Chapter on bug minimization Open

A-bug-minimization C-enhancement E-medium T-compiler

Difficulty 4/5 3-5 days Newbie friendliness 45/100

rust-lang/rustc-dev-guide#1649 · 3 reactions · Opened Mar 17, 2023
Move stability attribute section to std dev guide? Open

A-stability C-cleanup E-easy T-compiler T-libs

Difficulty 3/5 1-2 days Newbie friendliness 35/100

rust-lang/rustc-dev-guide#1493 · 3 comments · 2 reactions · Opened Oct 24, 2022
cleanup the remaining mentions of `rustc_typeck` Open

A-type-check C-cleanup E-medium T-compiler

Difficulty 2/5 1-3 hours Newbie friendliness 48/100

rust-lang/rustc-dev-guide#1491 · 1 reaction · Opened Oct 21, 2022
Running tests manually for check-pass? Open

A-compiletest A-test-suite E-hard I-terse T-bootstrap T-compiler

Difficulty 2/5 1-3 hours Newbie friendliness 38/100

rust-lang/rustc-dev-guide#1318 · 2 comments · Opened Feb 26, 2022
Instructions for adding a new query Open

A-incr-comp A-query-system E-hard I-terse T-compiler

Difficulty 3/5 1-2 days Newbie friendliness 45/100

rust-lang/rustc-dev-guide#1299 · 8 comments · Opened Feb 17, 2022
Describe query recovery Open

A-incr-comp A-query-system E-hard T-compiler

Difficulty 2/5 1-3 hours Newbie friendliness 45/100

rust-lang/rustc-dev-guide#1285 · 1 comment · 1 reaction · Opened Jan 4, 2022
Consolidate HKTBs, leak-check and universes information around with what we have in the guide Open

A-leak-check C-tracking-issue E-hard E-needs-investigation E-needs-writeup T-types

Difficulty 4/5 3-5 days Newbie friendliness 35/100

rust-lang/rustc-dev-guide#1184 · 1 comment · Opened Aug 6, 2021
Add section about self-profiling and measureme Open

A-performance E-medium E-needs-info E-needs-investigation T-compiler WG-compiler-performance

Difficulty 3/5 1-2 days Newbie friendliness 45/100

rust-lang/rustc-dev-guide#1174 · 1 comment · 2 reactions · Opened Jul 22, 2021
Document how lints are actually emitted Open

A-lints C-enhancement E-hard E-needs-investigation T-compiler

Difficulty 4/5 3-5 days Newbie friendliness 42/100

rust-lang/rustc-dev-guide#1168 · 2 comments · Opened Jul 4, 2021
Document HIR structure Open

A-HIR C-enhancement E-hard T-compiler

Difficulty 4/5 3-5 days Newbie friendliness 30/100

rust-lang/rustc-dev-guide#1167 · 1 comment · Opened Jul 4, 2021
Add information on running the compiler with cachegrind and valgrind Open

A-performance C-enhancement E-medium T-compiler WG-compiler-performance

Difficulty 2/5 1-3 hours Newbie friendliness 38/100

rust-lang/rustc-dev-guide#1166 · 1 comment · Opened Jul 4, 2021
Section Review: 31.1 Lexing and Parsing & 31.2 Macro Expansion Open

A-lexing A-macro-expansion A-parser C-section-review E-hard T-compiler

Difficulty 4/5 3-5 days Newbie friendliness 38/100

rust-lang/rustc-dev-guide#1165 · Opened Jul 2, 2021
Document inline assembly Open

A-inline-asm C-enhancement E-medium T-compiler T-libs

Difficulty 5/5 Over a week Newbie friendliness 25/100

rust-lang/rustc-dev-guide#1162 · Opened Jul 1, 2021

rust-lang/rustc-dev-guide

Get new issues in your inbox