rust-lang/rustc-dev-guide

View on GitHub

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

Stars: 1.9k
Forks: 612
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

Finish chapter on type checking Open

A-HIR A-MIR A-THIR A-type-check C-enhancement E-hard T-compiler T-types

rust-lang/rustc-dev-guide#1161 · 3 comments · 12 reactions · 1 assignee · Opened Jul 1, 2021
Add more detail on procedural macros and custom derive Open

A-proc-macros C-enhancement E-hard T-compiler

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

rust-lang/rustc-dev-guide#1160 · 1 comment · 3 reactions · Opened Jul 1, 2021
Document more of how to debug HIR Open

A-contributor-onboarding A-HIR E-medium I-terse T-compiler

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

rust-lang/rustc-dev-guide#1159 · 1 comment · Opened Jul 1, 2021
Link to demangler source in section on using a debugger Open

A-debuggers A-debuginfo E-hard T-compiler

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

rust-lang/rustc-dev-guide#1157 · 2 comments · Opened Jul 1, 2021
Consider removing sections about std/core libraries Open

A-meta C-discussion T-libs WG-rustc-dev-guide

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

rust-lang/rustc-dev-guide#1156 · 6 comments · Opened Jul 1, 2021
Transcribe the Compiler Lecture evaluation caching trait solver Open

E-help-wanted E-needs-writeup

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

rust-lang/rustc-dev-guide#1140 · Opened Jun 11, 2021
One sentence per line? Open

A-meta A-style C-CI C-discussion WG-rustc-dev-guide

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

rust-lang/rustc-dev-guide#1132 · 15 comments · 9 reactions · Opened May 26, 2021
The explanation of Rustdoc internals is partially outdated Open

C-bug I-outdated T-rustdoc

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

rust-lang/rustc-dev-guide#1130 · Opened May 21, 2021
query system no longer lives inside rustc_middle ? Open

A-query-system E-hard E-help-wanted I-outdated T-compiler

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

rust-lang/rustc-dev-guide#1091 · 1 comment · 4 reactions · Opened Mar 20, 2021
Document interaction between incremental compilation and diagnostics Open

A-diagnostics A-incr-comp C-enhancement E-hard T-compiler

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

rust-lang/rustc-dev-guide#1090 · 1 reaction · Opened Mar 16, 2021
Tracking issue for "Compiler walkthrough" section Open

C-tracking-issue E-hard T-compiler X-workthrough

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

rust-lang/rustc-dev-guide#1062 · 6 comments · Opened Feb 18, 2021
Guide on the "social aspects" of compiler development Open

A-meta A-social C-enhancement E-hard T-compiler

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

rust-lang/rustc-dev-guide#1061 · 3 comments · 1 reaction · Opened Feb 18, 2021
Document that linkcheck only looks at modified files when running locally Open

A-linkcheck C-CI E-needs-investigation E-needs-writeup

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

rust-lang/rustc-dev-guide#1034 · 5 comments · Opened Jan 22, 2021
Define `DefCollector` in HIR lowering section Open

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

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

rust-lang/rustc-dev-guide#1011 · 1 comment · Opened Jan 6, 2021
Define "existential impl Trait" and "universal impl Trait" Open

A-glossary C-enhancement E-medium T-compiler T-types

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

rust-lang/rustc-dev-guide#1010 · 1 comment · Opened Jan 6, 2021
Define "definition", "node", and "item" more precisely in section on hir Open

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

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

rust-lang/rustc-dev-guide#1009 · 5 comments · Opened Jan 6, 2021
Replace all todos with issues Open

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

rust-lang/rustc-dev-guide#1006 · 5 comments · 4 reactions · 1 assignee · Opened Jan 4, 2021
On MIR dataflow convergence Open

A-dataflow A-MIR A-mir-opt E-hard E-needs-investigation T-compiler

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

rust-lang/rustc-dev-guide#990 · 9 comments · Opened Dec 16, 2020
Add logging in rustc itself that links to the dev-guide Open

C-discussion

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

rust-lang/rustc-dev-guide#949 · 5 comments · Opened Nov 10, 2020
Add a diagram of how rustc types relate to one another Open

C-enhancement E-hard T-compiler

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

rust-lang/rustc-dev-guide#948 · Opened Nov 10, 2020
Create examples of using rustc for common tasks Open

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

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

rust-lang/rustc-dev-guide#947 · Opened Nov 10, 2020
Add a section on the lexer and expand the section on rustc_ast Open

A-AST A-lexing C-enhancement E-hard T-compiler

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

rust-lang/rustc-dev-guide#946 · Opened Nov 10, 2020
Notes about MIR generation for match expressions Open

A-match A-MIR C-enhancement E-hard T-compiler

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

rust-lang/rustc-dev-guide#943 · 1 comment · 2 reactions · Opened Nov 7, 2020
Explain difference between `rustc_middle::{something}` and `rustc_{something}` in rustc dev guide Open

A-contributor-roadblock A-docs A-meta C-enhancement T-compiler

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

rust-lang/rustc-dev-guide#2175 · 5 comments · Opened Oct 28, 2020
Document that you don't need to build the compiler to work on libraries Open

C-cleanup E-easy I-confusing T-libs WG-rustc-dev-guide

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

rust-lang/rustc-dev-guide#873 · 2 comments · Opened Sep 10, 2020
Provide "how to use" for each section of rustc-dev-guide Open

A-meta E-medium WG-rustc-dev-guide

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

rust-lang/rustc-dev-guide#853 · 3 reactions · Opened Sep 6, 2020
Difficult to find 'How to structure your PR' Open

A-contribution-workflows A-meta A-social E-hard T-compiler

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

rust-lang/rustc-dev-guide#831 · 2 comments · 1 reaction · Opened Aug 19, 2020
Recommend `git absorb` in coding conventions section Open

A-git A-tooling C-enhancement

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

rust-lang/rustc-dev-guide#824 · Opened Aug 12, 2020
rustc-middle shows up in text without explanation Open

E-medium I-confusing T-compiler

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

rust-lang/rustc-dev-guide#812 · 1 reaction · Opened Jul 27, 2020
Add `Compiler::compile()` like docs Open

A-custom-driver C-enhancement E-hard T-compiler

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

rust-lang/rustc-dev-guide#799 · Opened Jul 15, 2020
Make contributing.md into a series of tutorials Open

A-contribution-workflows A-meta A-organization C-enhancement T-compiler

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

rust-lang/rustc-dev-guide#775 · 7 comments · 2 reactions · Opened Jun 28, 2020
Fill out MIR section on constants and constant promotion Open

A-const-eval C-enhancement E-hard T-compiler WG-const-eval

rust-lang/rustc-dev-guide#770 · 1 comment · 1 reaction · 1 assignee · Opened Jun 25, 2020
Reorganize files Open

A-meta A-organization C-cleanup E-medium WG-rustc-dev-guide

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

rust-lang/rustc-dev-guide#762 · 2 comments · Opened Jun 23, 2020
Add more about why stage 2 is useful and what constraints bootstrapping has Open

C-enhancement E-hard E-help-wanted E-needs-writeup T-bootstrap T-compiler

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

rust-lang/rustc-dev-guide#726 · 4 comments · Opened May 28, 2020
New Diagrams in the guide Open

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

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

rust-lang/rustc-dev-guide#708 · 1 comment · 2 reactions · Opened May 19, 2020
Add "landing pads" to the glossary Open

A-glossary C-enhancement E-medium T-compiler T-libs

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

rust-lang/rustc-dev-guide#707 · 8 comments · Opened May 19, 2020
Look through closures meeting Open

A-closures E-help-wanted E-medium E-needs-writeup T-compiler

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

rust-lang/rustc-dev-guide#704 · 3 reactions · Opened May 15, 2020
Document new mir-opt test format. Open

A-mir-opt A-test-suite C-cleanup E-easy E-mentor T-compiler

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

rust-lang/rustc-dev-guide#701 · 8 comments · 2 reactions · Opened May 11, 2020
Overview Chapter Followup Open

A-compiler-architecture C-tracking-issue E-hard E-help-wanted T-compiler

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

rust-lang/rustc-dev-guide#674 · 10 comments · 5 reactions · Opened Apr 14, 2020
improve/fix "codegen" definition Open

A-codegen A-glossary E-medium I-confusing T-compiler

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

rust-lang/rustc-dev-guide#637 · 1 comment · Opened Mar 28, 2020
Fill in holes in backend chapters Open

A-cg-cranelift A-codegen A-const-eval A-LLVM A-monomorphization C-enhancement C-tracking-issue E-hard T-compiler

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

rust-lang/rustc-dev-guide#620 · Opened Mar 17, 2020
Collect a set of PRs that help understanding some parts of the compiler Open

A-examples C-tracking-forever C-tracking-issue E-help-wanted T-compiler

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

rust-lang/rustc-dev-guide#619 · 6 comments · 6 reactions · Opened Mar 17, 2020
The text of the guide should not be included as code comments Open

A-style C-cleanup T-compiler

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

rust-lang/rustc-dev-guide#615 · 4 comments · 1 reaction · Opened Mar 16, 2020
Explain the technical parts of the Walkthrough somewhere Open

A-walkthrough C-discussion T-compiler

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

rust-lang/rustc-dev-guide#584 · 2 comments · Opened Feb 18, 2020
Document slice patterns Open

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

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

rust-lang/rustc-dev-guide#563 · 1 comment · Opened Jan 18, 2020
Add dump-mir=<val> options Open

-Zdump-mir A-contributor-devex A-MIR A-mir-opt C-enhancement E-medium T-compiler

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

rust-lang/rustc-dev-guide#518 · Opened Nov 14, 2019
Add mir-opt-level information Open

-Zdump-mir -Zmir-opt-level A-MIR A-mir-opt C-enhancement E-hard T-compiler

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

rust-lang/rustc-dev-guide#517 · Opened Nov 14, 2019
Add dump-mir-dir information Open

-Zdump-mir -Zdump-mir-dir A-contributor-devex A-MIR A-mir-opt C-enhancement E-medium T-compiler

Difficulty 1/5 1-3 hours Newbie friendliness 58/100

rust-lang/rustc-dev-guide#516 · Opened Nov 14, 2019
">" in bash scripts Open

A-style C-cleanup E-easy WG-rustc-dev-guide

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

rust-lang/rustc-dev-guide#515 · 2 comments · 2 reactions · Opened Nov 14, 2019
Double-check we did everything from rust-lang/rust#40902 Open

C-enhancement C-tracking-issue E-needs-investigation T-compiler

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

rust-lang/rustc-dev-guide#448 · 2 comments · Opened Sep 18, 2019

rust-lang/rustc-dev-guide

Get new issues in your inbox