Stream: t-compiler/wg-learning

Topic: rustc-guide strike force


mark-i-m (Jul 23 2019 at 20:22, on Zulip):

I will post the draft IRLO post here in a bit

mark-i-m (Jul 23 2019 at 20:23, on Zulip):

Ok here it is

mark-i-m (Jul 23 2019 at 20:23, on Zulip):

# Announcing the rustc-guide Strike Force

The rustc-guide is the official
resource for discovering how the compiler works and how to contribute to it. It
has come a _looong_ way since it was created a year and a half ago!

As a result, we now have over [70 issues][issues] on the repo, some of which
have unfortunately become quite stale. The [Learning Working Group][wg] is
creating a Strike Force to triage these issues, determine the action items for
them, and try to get some work started on them.

But we there is _a lot_ of work! We need your help! If this sounds like an
interesting way for you to contribute, please ping us in [this Zulip
topic][rgsf].

[rgsf]: https://rust-lang.zulipchat.com/#narrow/stream/196385-t-compiler.2Fwg-learning/topic/rustc-guide.20strike.20force
[wg]: https://github.com/rust-lang/compiler-team/tree/master/content/docs/working-groups/learning
[issues]: https://github.com/rust-lang/rustc-guide/issues

mark-i-m (Jul 23 2019 at 20:23, on Zulip):

@Santiago Pastorino Let me know what you think

Santiago Pastorino (Jul 23 2019 at 20:28, on Zulip):

@mark-i-m it's perfect

Santiago Pastorino (Jul 23 2019 at 20:28, on Zulip):

and very nice that you've already opened and linked a thread so it's easy for people to jump in and say that they are interested in helping

mark-i-m (Jul 23 2019 at 20:41, on Zulip):

Ok, I will post it on IRLO

Francesco Dainese (Jul 24 2019 at 07:02, on Zulip):

I've been wanting to contribute for a while and this seems like an interesting place to start

Francesco Dainese (Jul 24 2019 at 14:17, on Zulip):

@WG-learning Forgot to ping you

Santiago Pastorino (Jul 24 2019 at 14:40, on Zulip):

@Francesco Dainese cool, would be nice to have you around :)

Santiago Pastorino (Jul 24 2019 at 14:40, on Zulip):

do you want to be added to @*WG-learning* group?

Francesco Dainese (Jul 24 2019 at 14:59, on Zulip):

Mmh I think it's better if I do some work first. Where should I start?

Santiago Pastorino (Jul 24 2019 at 18:07, on Zulip):

the group is for notification purposes

Santiago Pastorino (Jul 24 2019 at 18:07, on Zulip):

about meetings, etc but as you will

Santiago Pastorino (Jul 24 2019 at 18:07, on Zulip):

about where to start ... we have a bunch of lectures that some of the compiler team members gave and we are currently trying to convert them into rustc-guide chapters

Santiago Pastorino (Jul 24 2019 at 18:08, on Zulip):

@Francesco Dainese in particular check the To do column here https://github.com/rust-lang/rustc-guide/projects/2 and if you like to work on any of those issues let me know

Santiago Pastorino (Jul 24 2019 at 18:10, on Zulip):

but I think you can just comment write a comment on the issue you're interested with the text @rustbot claim and the bot will assign it to you

Santiago Pastorino (Jul 24 2019 at 18:10, on Zulip):

so the idea is that people helping with this project will choose one of those lectures, watch them and write a chapter about how that specific part of the compiler works

Santiago Pastorino (Jul 24 2019 at 18:12, on Zulip):

feel free to ask questions around :)

Santiago Pastorino (Jul 24 2019 at 18:21, on Zulip):

btw

Santiago Pastorino (Jul 24 2019 at 18:21, on Zulip):

https://twitter.com/spastorino/status/1154094109327597568

Santiago Pastorino (Jul 24 2019 at 18:21, on Zulip):

@mark-i-m probably twitter can help us in getting more interested folks

Santiago Pastorino (Jul 24 2019 at 18:22, on Zulip):

@rust-lang account would probably RT for further reach

Santiago Pastorino (Jul 24 2019 at 18:23, on Zulip):

notified Steve about it, just in case he misses it

mark-i-m (Jul 24 2019 at 18:51, on Zulip):

@Santiago Pastorino You may be right, but I am not on twitter :P

mark-i-m (Jul 24 2019 at 18:51, on Zulip):

Feel free to repost it there if you want

Santiago Pastorino (Jul 24 2019 at 18:52, on Zulip):

have already done that :)

Rohit Goswami (Jul 24 2019 at 18:59, on Zulip):

Hey, so I was hoping to work on the Lecture on Universes and Lifetimes
If that's ok

Santiago Pastorino (Jul 24 2019 at 19:00, on Zulip):

Hey, so I was hoping to work on the Lecture on Universes and Lifetimes
If that's ok

sure, comment with @rustbot claim on the issue

Rohit Goswami (Jul 24 2019 at 19:02, on Zulip):

Yup, just did that. I'm a little green when it comes to rust, but I have had a lot of experience writing up things. I was actually swayed by the README.md where it says it's ok to not know all the details. Hoping to learn a bit while I write this up :)

Santiago Pastorino (Jul 24 2019 at 19:02, on Zulip):

definitely

Santiago Pastorino (Jul 24 2019 at 19:02, on Zulip):

feel free to ask questions to see if someone can help you

Rohit Goswami (Jul 24 2019 at 19:03, on Zulip):

Sure, thanks a ton :)

mark-i-m (Jul 24 2019 at 19:04, on Zulip):

Welcome @Francesco Dainese and @Rohit Goswami

Francesco Dainese (Jul 24 2019 at 20:15, on Zulip):

I claimed the lecture about how salsa works

Francesco Dainese (Jul 24 2019 at 20:15, on Zulip):

I was wondering what you mean with "Transcribe"

IƱaki Garay (Jul 24 2019 at 20:18, on Zulip):

More than transcribing word-for-word it's summarize. One listens to the lecture and writes down relevant information

Santiago Pastorino (Jul 24 2019 at 20:26, on Zulip):

I was wondering what you mean with "Transcribe"

it's basically listening to the lecture, understanding it and write that down in the rustc-guide chapter format

Santiago Pastorino (Jul 24 2019 at 20:27, on Zulip):

more like convert the knowledge that is in the video into a chapter

mark-i-m (Jul 24 2019 at 20:29, on Zulip):

Also, triage work on the rustc-guide is very welcome. This can be a smaller time commitment since you can basically just start/stop whenever. Basically, there are a ton of issues open and figuring out what the status of each one is can be a lot of work.

Francesco Dainese (Jul 24 2019 at 21:01, on Zulip):

it's basically listening to the lecture, understanding it and write that down in the rustc-guide chapter format

Yeah that's what I thought. Alright then

Santiago Pastorino (Jul 24 2019 at 21:31, on Zulip):

and also what @mark-i-m is saying is very important too, if you want to help triaging the issue tracker that's also a huge help

Francesco Dainese (Jul 25 2019 at 07:36, on Zulip):

I tried to do some triage on rust-lang/rustc-guide#14, let me know if it's correct

Geert Van Laethem (Jul 25 2019 at 08:18, on Zulip):

@mark-i-m @Santiago Pastorino I want to help out if you can guide me what to do.

Santiago Pastorino (Jul 25 2019 at 13:13, on Zulip):

@Geert Van Laethem we are currently aiming for two things

Santiago Pastorino (Jul 25 2019 at 13:14, on Zulip):

1. being doing some triage work on the issue tracker, that means checking issues, investigating a bit, if it's a PR have a back and forth with authors, maybe fixing them, so making things move forward and basically checking and reaching a decision about the status of the issue and what would be the next step to have them closed. Maybe @mark-i-m can add more here

Santiago Pastorino (Jul 25 2019 at 13:16, on Zulip):

2. choosing an issue from the To do column of this project https://github.com/rust-lang/rustc-guide/projects/2 and working on it. We had a bunch of compiler lectures with somebody from the rust compiler team explaining some particular area of the compiler. We have the videos of the lectures and the idea is to watch them, understand them, ask questions and write a chapter guide for rustc-guide about that topic.

Santiago Pastorino (Jul 25 2019 at 13:39, on Zulip):

@mark-i-m when you have some time merge this https://github.com/rust-lang/rustc-guide/pull/399 so the CI is happy :)

Geert Van Laethem (Jul 25 2019 at 13:51, on Zulip):

@Santiago Pastorino I want to help with number 2. Sounds fun to do and learn from it at the same time.
Do you assign one to me or how does it work?

Francesco Dainese (Jul 25 2019 at 13:55, on Zulip):

You comment @rustbot claim on the issue, you'll be assigned later on
@Geert Van Laethem

Geert Van Laethem (Jul 25 2019 at 14:02, on Zulip):

Thanks @Francesco Dainese. I start working on https://github.com/rust-lang/rustc-guide/issues/360 tonight.

mark-i-m (Aug 06 2019 at 15:20, on Zulip):

Sorry, I've been rather absent, and will continue to be for another two weeks roughly...

I tried to do some triage on rust-lang/rustc-guide#14, let me know if it's correct

@Francesco Dainese That looks like exactly what we are looking for. Thanks :)

Last update: Nov 15 2019 at 21:35UTC