18:05 <paulproteus> (I'm back. Oops.)

19:11 <rustyrazorblade> hello

19:14 <rustyrazorblade> zarvox: good meeting you @ rust camp. i’m this guy -> https://twitter.com/rustyrazorblade

19:16 <dwrensha> rustyrazorblade: oh, I saw you on twitter mentioning capnproto-rust!

19:16 <rustyrazorblade> hey dwrensha

19:16 <rustyrazorblade> yeah, i just started messing with it

19:17 <rustyrazorblade> you accepting PRs to the readme for install / first time setup help?

19:17 <dwrensha> definitely

19:18 <rustyrazorblade> awesome. i was a bit thrown off by the 2 repos, one as a lib other as exec

19:18 <rustyrazorblade> i’ll be playing with it this week so once I have a good grasp on how stuff works i’ll put up a PR for you

19:21 <dwrensha> yeah, the runtime library and code generation are separate crates

19:21 <dwrensha> and cargo seems to really prefer having one crate per git repo

19:22 <rustyrazorblade> totally fine to do it that way, I think the callout should just be more promintent. it’s easy to miss

19:22 <rustyrazorblade> my rust skills are pretty bad so I was trying to figure out if I had done something really stupid (i did) but I went in the wrong direction about 10 times

19:22 <rustyrazorblade> i didn’t really read the readme carefully, so user error

19:23 <dwrensha> and there's also the fact the the addressbook example is buried in a subdirectory of capnpc-rust, when it really should be the first thing people see

19:23 <rustyrazorblade> i think it would be helpful to have a quickstart right in the readme

19:24 <rustyrazorblade> just showing how to generate & use your first lib

19:24 <dwrensha> hm. I wonder whether the README is the place for that, or would the front page of docs.capnproto-rust.org be better?

19:24 <rustyrazorblade> similar to what we did here: https://github.com/cqlengine/cqlengine

19:26 <rustyrazorblade> the readme doesn’t have to be a comprehensive example, but I think showing a very small example (say a single type with 3 fields) would make it very approachable

19:26 <dwrensha> I do rather like the way that https://github.com/sandstorm-io/capnproto pushes the user to https://capnproto.org, where all of the good stuff is

19:28 <rustyrazorblade> i think it should absolutely do that - the problem i’m trying to solve is the first impression. having to click through a bunch of stuff, for most people, leads to confusion. seeing a very simple, real example in the readme gives someone a feel for what they’re looking for as they traverse the docs.

19:28 <rustyrazorblade> at the end of the simplest example possible, link to docs to read the rest

19:29 <dwrensha> that sounds reasonable

19:29 <dwrensha> in any case, I'd be grateful for any help with the documentation. :)

19:29 <dwrensha> Feel free to poke me here if you have any questions.

19:30 <rustyrazorblade> absolutely. i keep my client in this chat going fwd

21:55 <erikoeurch> dwrensha, any progress on the gitlab-sandstorm graphs page bug? :)

22:11 <dwrensha> erikoeurch: sorry, I haven't gotten around to it

22:12 <erikoeurch> okay