rust-lang/rustc-reading-club

Rust Code Reading Clubs

Rust Code Reading Clubs

rustc edition

rustc-reading-club's Issues

google calendar

We should probably make a google calendar? We could also use the Rust community calendar. It's nice for folks to be able to subscribe to a calendar though.

Add Rules for Reading Session Participation

broken links in README

Description

unlinked references to "[rustc]" can be found in the first paragraph of the book

Acceptance Criteria

• fix broken links in book

The Code Annotation Tool tool does not work

After pasting the github link, the tool warning: This is not a github link.

update code of conduct

currently it's a blank file! we should use rust coc

[Topic]: MIR Analyses

Contact Details

[email protected]

Which rustc topic would you like to suggest?

MIR Analysis (and in particular, Dataflow based analysis) is a very important topic to me, but I had a hard time getting around the code itself and the little bits and pieces when I tried making NL(CP) happen. Now I've put this project on hiatus (as of about 3 weeks ago, I've cancelled my thesis which was based on that work c': ), and because of uni I'm not gonna get back at it full steam until I'm able to graduate.

I would like to understand... okay, so this is the current picture I have in my mind of how the compiler processes code:

---

Text ==> Rust ==> HIR ==> <<MIR>> || Frontend-Backend boundary || ==> <<LLVM>> ==> Binary

Where <<bloop>> means the bloop stage loops back into itself many times

And inside of that...

• Rust ==> HIR simplifies rust code (and does macro expansion?)
• <<MIR>> makes high-level analyses and transforms such as... non-lexical lifetime analysis, (trait resolution?) and high-level optimizations.

---

The thing is, I would love to understand how we perform everything inside <<MIR>>. It's a very important topic for me. Both because it helps Clippy, which can help attest for program correctness... and because it helps reduce compile times and it will one day help us optimize beyond what LLVM alone can give us.

And, maybe this is just me or maybe I'm just code-shy, but I feel like my theoretical understanding of some of the program analysis topics is good enough for where the compiler's at. Yet it's still super hard for me to step at a point in rustc's MIR Analysis code and know what's up, let alone draft new code to add to it. That's what I would like to learn the most: how to be confident enough with the compiler's code so that I could give back to it from my harvests.

Relevant code file URL

• https://doc.rust-lang.org/nightly/nightly-rustc/rustc_mir_dataflow/index.html
• https://rustc-dev-guide.rust-lang.org/mir/dataflow.html (docs)
  And:
• rust-lang/rustc-dev-guide#990
• rust-lang/rust#80038 (comment)
  (These two links are more about my issues with the docs. Don't take the current docs at face value, because currently they're not quite correct. Just in case you might feel that something's weird about them: it might not be you, but the explanations that are off)

Code of Conduct

• I agree to follow this project's Code of Conduct

adjust labels

I propose the following labels:

• "organizer" -- things the organizers should do!
• "proposed topic" -- for proposed topics

[Request]: rust-lang.github.io/rustc-reading-club is very confusing

Contact Details

No response

Organizer Request

This is similar to #22 regarding organization, but it's more centered on the website rust-lang.github.io/rustc-reading-club:

• under "meetings" there is only one, very old meeting
• it's not clear if the calendar referenced is abandoned or not (for example, there is no future event market

Essentially, it's not clear (to me) if the website/calendar is abandoned, and one should look elsewhere (in this case, I think it'd be best to take put a message on the entry page), or not.

Code of Conduct

• I agree to follow this project's Code of Conduct

create issue templates

following up with #2, let's make issue templates for people proposing topics or requesting things from the organizers

[Request]: What is the status of RRC?

Contact Details

No response

Organizer Request

Hi! I'm trying to find current information on RRC and how to participate / catch up to where things currently are.

Has the "at scale" portion been hit yet (I signed up!)? https://smallcultfollowing.com/babysteps//blog/2021/11/18/rustc-reading-club-take-2/

Code of Conduct

• I agree to follow this project's Code of Conduct

create a zoom room and link to it

we need a zoom room. I can use my account. We need to link to it. For the CTCFT, I only put the link in the meeting invite. I'm not sure why I do that.

Need an email address for CoC reports

Create an email address that forwards CoC reports to whomever is responsible for resolving reports.

[Request]: Allow more participants in the zoom meeting

Contact Details

No response

Organizer Request

I am unable to join the meeting on zoom, i keep getting the message " the meeting has reached maximum capacity"

Code of Conduct

• I agree to follow this project's Code of Conduct

The GitHub pages site is gone, without warning

Contact Details

[email protected]

Organizer Request

The GitHub pages site is gone.

It was definitely online a few days ago, but now it's gone, without warning. The Medium page still refers to it.

Code of Conduct

• I agree to follow this project's Code of Conduct

write blog post and tweet to share with other Rust accounts

I propose we write an announcement blog post which can be shared on other people's social media accounts.

Also, compose a tweet announcement that can be posted by other Rust community accounts.

[Request]: How to find the Zoom link

Contact Details

No response

Organizer Request

Hi - hope this is the right place to ask this:

on the "how to attend" page you say "Each calendar entry contains the Zoom link.",

in the calendar there is an entry right now (2022-03-16, 18:15 CET), but i do not see a zoomlink

Code of Conduct

• I agree to follow this project's Code of Conduct

[Request]: Enable participants to "catch up" on missed sessions (on their own)

Contact Details

[email protected]

Organizer Request

If I am forced to miss a reading club session (due to a schedule conflict or unforeseen event), I would like to be able to attend the next session with sufficient context to participate. In cases where a session builds on the prior session(s), this would require me to "catch up" on the content from the missed session, which may be difficult because the sessions are not recorded.

Some suggestions for enabling this kind of catch-up:

• After each session, post which sections (in line numbers and/or functions) of the code were covered. This could be broken down by the "broadly" and "deeply" discussed sections.
• During each session, for each exercise or question asked, capture (perhaps with very little detail) some of the ideas or insights brought up
• Before each session, post some observations or questions that came up in the previous session that the facilitator expects will be relevant.

Code of Conduct

• I agree to follow this project's Code of Conduct