# 2021-12-02 ## RRC FTW Welcome to the Rustc reading club! --- # Goals: * Get familiar with the "patterns" of rustc * Learn what supporting resources are available * Get vague idea of what code does what * Deepen understanding of specific pieces of code * Have fun! :rainbow: :unicorn_face: --- # Non-goals: * Rust tutorial * Polished lecture on how rustc works --- # To best do that: * We want to hear from everyone * Encourage all questions * It's ok to ask "what is this `'tcx` lifetime I see on every other line of the code" --- (If you don't know what I'm talking about, don't worry, you will) --- # This is not recorded  --- # Plan for today  --- * Read the Rustc Name Resolution code * Answer this: * What are the most interesting pieces of this code to you? --- # Broad, deep, broad Answer The Question 3 times: * Broad: look at the module as a whole * Deep: pick one function or area to focus on * Broad: go back to the module as a whole * informed by previous two rounds --- # Let's go broad * Take 10 minutes to read code * Use [this link](https://annotate.code-reading.org/#/) to add annotations * Source code: https://is.gd/Zoha3z (or other files reachable from there) * Questions to answer: * What are the most interesting pieces of this code to you? * What is something you might like to "go deep" on in the next round? --- # Let's go deep * We'll pick a function / module / whatever to dive deep on based on what we heard * Take 10 minutes to read code * Use [this link](https://annotate.code-reading.org/#/) to add annotations * Read for 10 minutes, annotating, and thinking about: * What are the primary structures that are interested to you? (And why?) --- # Let's go broad again * Take 10 minutes to read code * Use [this link](https://annotate.code-reading.org/#/) to add annotations * Questions to answer: * Did you see anything that you didn't realize before? --- # An experiment :microscope:  --- # How did it go? * Next time we had planned to repeat with new question * Other ideas for future events: * Pick a bug and work through it * ...?