Stream: project-error-handling

Topic: book bof


view this post on Zulip oliver (Apr 08 2021 at 14:17):

/me stuck in a conference for the next 48hrs

view this post on Zulip oliver (Apr 08 2021 at 14:37):

it's good stuck though https://plutojl.org/plutocon2021/

view this post on Zulip Jane Lusby (Apr 08 2021 at 14:44):

Oh nice

view this post on Zulip Jane Lusby (Apr 08 2021 at 14:44):

Have fun!

view this post on Zulip oliver (Apr 08 2021 at 14:45):

lolol thanks

view this post on Zulip oliver (Apr 08 2021 at 14:45):

it's open to anyone

view this post on Zulip Jane Lusby (Apr 08 2021 at 18:00):

going to be a little late

view this post on Zulip Jane Lusby (Apr 08 2021 at 18:00):

phone call running long

view this post on Zulip Jane Lusby (Apr 08 2021 at 18:02):

https://us05web.zoom.us/j/81200042975?pwd=Qzh2bE1HSHJPK1hPM0REK1NNWXQxZz09

view this post on Zulip Jane Lusby (Apr 08 2021 at 18:03):

planning doc: https://cryptpad.fr/code/#/2/code/edit/1FhyaBOOANgdSTKA8xbYIt8t/

view this post on Zulip Jane Lusby (Apr 08 2021 at 18:06):

gonna cancel this one because it seems like people are busy, if anyone has anything they want to talk about lmk and I can start the video call again

view this post on Zulip Jane Lusby (Apr 08 2021 at 18:06):

@Charles Ellis O'Riley Jr. has been making steady progress on the diagram

view this post on Zulip Jane Lusby (Apr 08 2021 at 18:06):

beyond that I don't think there's been much work in the last few weeks

view this post on Zulip Charles Ellis O'Riley Jr. (Apr 08 2021 at 18:06):

Was late to the meeting

view this post on Zulip Jane Lusby (Apr 08 2021 at 18:07):

did you have anything else you wanted to talk about charles?

view this post on Zulip Jane Lusby (Apr 08 2021 at 18:07):

I still need to get back to you on your most recent version of the chart

view this post on Zulip Jane Lusby (Apr 08 2021 at 18:07):

I figured we could keep that async since everyone else is busy

view this post on Zulip Charles Ellis O'Riley Jr. (Apr 08 2021 at 18:07):

no. I'm good.

view this post on Zulip oliver (Apr 08 2021 at 18:14):

we could start defining tasks asynchronously and discuss at the general meeting

view this post on Zulip oliver (Apr 08 2021 at 18:15):

the big one is still document structure which includes a data dump of all users experience of error handling

view this post on Zulip oliver (Apr 08 2021 at 18:16):

if we could have better structure around content broken up into smaller tasks idk where to start tho

view this post on Zulip Jane Lusby (Apr 08 2021 at 18:22):

yea

view this post on Zulip oliver (Apr 08 2021 at 18:23):

starting is the hard part :grimacing:

view this post on Zulip Jane Lusby (Apr 08 2021 at 18:23):

I need to take an afternoon and parse through all the notes we've taken in the planning doc and organize + summarize it

view this post on Zulip Jane Lusby (Apr 08 2021 at 18:23):

I'll aim to do that before the next meeting and come up with a plan

view this post on Zulip Jane Lusby (Apr 08 2021 at 18:23):

and ill run it by you before then

view this post on Zulip Jane Lusby (Apr 08 2021 at 18:24):

or we can work on it together if you'd like

view this post on Zulip oliver (Apr 08 2021 at 18:25):

we should collab on it yeah

view this post on Zulip Sean Chen (he/him) (Apr 08 2021 at 18:26):

Sorry I didn't attend the book meeting. I did end up writing up a blog post based on some stuff Jane helped me out with as far as extending the minigrep project from the Book: https://github.com/seanchen1991/blog/blob/main/posts/extending-minigrep/index.md

view this post on Zulip oliver (Apr 08 2021 at 18:26):

a lot of people are caught up in the async vision process

view this post on Zulip Sean Chen (he/him) (Apr 08 2021 at 18:26):

The content can easily be repurposed for the book in the future

view this post on Zulip Jane Lusby (Apr 08 2021 at 18:27):

awesome

view this post on Zulip oliver (Apr 08 2021 at 18:27):

that's definitely a start :heart:

view this post on Zulip Jakub Duchniewicz (Apr 09 2021 at 12:10):

I was also afk yesterday :smile: glad you managed to do meet

view this post on Zulip Jane Lusby (Apr 22 2021 at 17:33):

Meeting in 30 minutes

view this post on Zulip Jane Lusby (Apr 22 2021 at 17:34):

today I was hoping we could review the diagram that @Charles Ellis O'Riley Jr. has been working on and plan how to piece it together

view this post on Zulip Jane Lusby (Apr 22 2021 at 17:57):

https://us05web.zoom.us/j/83105628234?pwd=NFM4VGRTK0p6RTgxeEhNc3hOQ2RqUT09

view this post on Zulip Jane Lusby (Apr 22 2021 at 18:00):

Here's the current version of the diagram

view this post on Zulip oliver (Apr 23 2021 at 00:08):

discussed pausing future BoFs until progress on book catches up with more contributors
also waiting to hear back on some style questions related to diagram tools and other guidelines for 'rust-doc' books

view this post on Zulip oliver (Apr 23 2021 at 00:11):

i.e. which diagram format [i.e. tool] is recommended? also anything about including custom graphical contents?

view this post on Zulip Charles Ellis O'Riley Jr. (Apr 23 2021 at 18:30):

Oliver, just informed Jane that I spent yesterday getting Graphviz set up on my machine. That was a tool that was used in the part of the Book that I looked at.

view this post on Zulip oliver (Apr 23 2021 at 20:22):

never used gv actually, I do that in R

view this post on Zulip Charles Ellis O'Riley Jr. (Apr 23 2021 at 21:28):

I have r studio. Can that go to git? I never used gv either

view this post on Zulip oliver (Apr 23 2021 at 21:29):

which package would you use?

view this post on Zulip Charles Ellis O'Riley Jr. (Apr 23 2021 at 22:01):

Don’t know. I don’t know if it can be saved to git.

view this post on Zulip oliver (Apr 23 2021 at 22:04):

rules eh :rolling_eyes:

view this post on Zulip Charles Ellis O'Riley Jr. (Apr 23 2021 at 22:05):

Found this: http://r4stats.com/examples/graphics-traditional/

view this post on Zulip oliver (Apr 23 2021 at 22:08):

look at ggdag

view this post on Zulip oliver (Apr 23 2021 at 22:10):

this is actually pretty hilarious: tidy_dag <- tidy_dagitty(dag)

view this post on Zulip Charles Ellis O'Riley Jr. (Apr 23 2021 at 22:13):

I’ll have to do further research. Found this also: https://rkabacoff.github.io/datavis/SavingGraphs.html

view this post on Zulip oliver (Apr 23 2021 at 22:14):

.png that's nice

view this post on Zulip oliver (Apr 23 2021 at 22:15):

or .svg

view this post on Zulip Charles Ellis O'Riley Jr. (Apr 23 2021 at 22:49):

.svg is used in the Book with gv

view this post on Zulip oliver (Apr 23 2021 at 22:57):

.svg for gv nice

view this post on Zulip oliver (Apr 23 2021 at 22:59):

to know that

view this post on Zulip oliver (Apr 24 2021 at 14:38):

existing Rust documentation seems _really_ sparse on diagrams now that I look at it

view this post on Zulip oliver (Apr 24 2021 at 14:55):

solving logic problems, [i.e. what Rust presents to 'the user'(sic)], may benefit from being visualized for the reader

view this post on Zulip Charles Ellis O'Riley Jr. (Apr 24 2021 at 15:19):

This link shows a diagram: https://doc.rust-lang.org/book/ch04-02-references-and-borrowing.html

view this post on Zulip oliver (Apr 24 2021 at 16:02):

:eyes:

view this post on Zulip oliver (Apr 24 2021 at 16:16):

v. illuminating

view this post on Zulip oliver (Apr 24 2021 at 16:29):

maybe we should start in the existing docs and add a diagram there
what could be done to show the memory model in a dag package?

view this post on Zulip oliver (Apr 24 2021 at 16:30):

ofc. rust _needs_ a memory model :laughing:

view this post on Zulip oliver (Apr 24 2021 at 16:36):

so hopefully we're not waiting on that

view this post on Zulip oliver (Apr 24 2021 at 16:47):

trying to think about this from a libs project perspective :thinking:

view this post on Zulip oliver (May 18 2021 at 16:06):

did we ever get feedback on which diagramming format is recommended/approved for Rust documents?

view this post on Zulip Charles Ellis O'Riley Jr. (May 18 2021 at 16:22):

Graphviz is what’s been used. Just did a pull request so you can check out the code.

view this post on Zulip oliver (May 18 2021 at 20:20):

cool, on the GH?

view this post on Zulip Charles Ellis O'Riley Jr. (May 18 2021 at 20:20):

GH?

view this post on Zulip Charles Ellis O'Riley Jr. (May 18 2021 at 20:21):

GitHub

view this post on Zulip oliver (May 18 2021 at 20:23):

yeah srry

view this post on Zulip Charles Ellis O'Riley Jr. (May 18 2021 at 20:26):

I understand you can call on this app now. How’s that done?

view this post on Zulip oliver (May 18 2021 at 20:26):

not yet, it's still wip

view this post on Zulip Charles Ellis O'Riley Jr. (May 18 2021 at 20:26):

K

view this post on Zulip Senyo Simpson (Jun 28 2021 at 15:06):

Just hijacking this topic. I opened a PR for some general feedback on a high level structure for the book: https://github.com/rust-lang/project-error-handling/pull/45

I'll refine the structure as feedback comes in.

@Jane Lusby @Sean Chen (he/him)


Last updated: Jan 29 2022 at 09:28 UTC