Stream: t-compiler/wg-learning

Topic: overview chapter


Santiago Pastorino (Nov 27 2019 at 13:08, on Zulip):

HackMD created https://hackmd.io/j8EsXGI1RiOnjZSiSRf3ng

mark-i-m (Nov 27 2019 at 15:31, on Zulip):

@WG-learning ^^^ This is the doc for the overview chapter... please add your questions to it

mark-i-m (Nov 27 2019 at 16:00, on Zulip):

I added some initial thoughts, but I am not 100% sure of their correctness...

Amanjeev Sethi (Nov 27 2019 at 16:30, on Zulip):

Thank you! I add a section for a flowchart of the same just in case we forget

Santiago Pastorino (Nov 27 2019 at 16:59, on Zulip):

@mark-i-m I'm having now thoughts about Overview and Walkthrough

Santiago Pastorino (Nov 27 2019 at 16:59, on Zulip):

what do you guys consider that should be included in one and in the other?

Amanjeev Sethi (Nov 27 2019 at 18:17, on Zulip):

From what I understand, Overview is abstract steps and Walkthrough is by example code(s).

Amanjeev Sethi (Nov 27 2019 at 18:17, on Zulip):

Not sure if I my understanding correct.

mark-i-m (Nov 27 2019 at 20:32, on Zulip):

I was actually wondering if it makes sense to have them as two separate chapters... I was thinking we could just have 1

Santiago Pastorino (Nov 27 2019 at 20:32, on Zulip):

yes, this is what I meant too

Santiago Pastorino (Nov 27 2019 at 20:33, on Zulip):

you can probably describe some things in the abstract but then go into a concrete example

Amanjeev Sethi (Nov 27 2019 at 20:38, on Zulip):

I was thinking of two chapters because I was hoping to have multiple levels of code examples.

Amanjeev Sethi (Nov 27 2019 at 20:38, on Zulip):

From simpler to more complex

Amanjeev Sethi (Nov 27 2019 at 20:39, on Zulip):

If we merge these two into one, I would love to have sub-chapters for an example each under this. What do you think?

Santiago Pastorino (Nov 27 2019 at 20:40, on Zulip):

I'd say that as soon as we figure out this first thing we can think about the rest ?

Amanjeev Sethi (Nov 27 2019 at 20:40, on Zulip):

Oh sure! I am not saying we have to get to that this second. :slight_smile: Sorry if I came off that way.

mark-i-m (Mar 17 2020 at 22:49, on Zulip):

Hi all, I updated the overview section notes a lot. In particular, I broke out two sections (1) what the compiler does to your code and (2) how it does it. Please let me know what you think of this organization

mark-i-m (Mar 20 2020 at 16:12, on Zulip):

Any thoughts?

Santiago Pastorino (Mar 20 2020 at 16:37, on Zulip):

gonna read it again

Santiago Pastorino (Mar 20 2020 at 16:59, on Zulip):

@mark-i-m everything is https://hackmd.io/j8EsXGI1RiOnjZSiSRf3ng right?

Santiago Pastorino (Mar 20 2020 at 16:59, on Zulip):

gonna read it again later

mark-i-m (Mar 20 2020 at 17:01, on Zulip):

Yes, thanks!

Chris Simpkins (Mar 22 2020 at 01:49, on Zulip):

This is shaping up great @mark-i-m !

Chris Simpkins (Mar 22 2020 at 02:19, on Zulip):

Do you think that it is far enough along to push the document to a branch of the rustc-dev-guide repository? I'd like to point to the working branch in the blog post if possible

mark-i-m (Mar 22 2020 at 22:24, on Zulip):

Hmm... I guess it could be

mark-i-m (Mar 22 2020 at 22:26, on Zulip):

Personally, I vaguely prefer the hackmd, but I do see the benefits of gh for getting feedback

Chris Simpkins (Mar 28 2020 at 01:07, on Zulip):

Anyone else interested in the lexer & parser sections? If not, I can work on those areas.

Chris Simpkins (Mar 30 2020 at 19:32, on Zulip):

Chris Simpkins said:

Anyone else interested in the lexer & parser sections? If not, I can work on those areas.

Centril and I are getting together later this week to discuss the parser. I'll begin adding parser Overview documentation after the meeting.

Chris Simpkins (Apr 03 2020 at 06:02, on Zulip):

WIP: https://github.com/rust-lang/rustc-dev-guide/pull/659 (based on @mark-i-m branch)

Last update: Apr 05 2020 at 01:10UTC