On Mon, Mar 14, 2016 at 4:31 PM, Hendrik Boom wrote: > > PR? I donn't know the acronym. > > Pull Request -- github's term for a proposed commit to a git repository. It supports a fairly detailed discussion mechanism on specific parts of the code, which could enable building up of documentation through a question-and-answer process. -Yotam > > (or others) would ask questions about functions I didn't understand, and > > other people would step up and explain them. Eventually, there might be > > some documentation and clarification to add to the code. This would > require > > tolerance of 'unhelpful' and question-based documentation PRs. There > might > > be some very basic questions in there. We could add a specific tag, so > > these PRs aren't closed prematurely (they could take a while). Would that > > be ok? > > > > -Yotam > > > > > > > On Mon, Mar 14, 2016 at 11:36 AM, Goswin von Brederlow < > goswin-v-b@web.de> > > > wrote: > > > > > >> On Fri, Mar 11, 2016 at 12:04:17PM -0500, Yotam Barnoy wrote: > > >> > While thinking about the best way to learn the new Flambda code in > the > > >> > minimal amount of time, I thought to myself, "wouldn't it be > amazing to > > >> > have Pierre Chambart and Mark Shinwell just do a video walkthrough > of > > >> their > > >> > code". And then I thought about the rest of the codebase, about > Jacques > > >> > Garrigue doing a walkthrough of the typechecker code, and each > expert(s) > > >> > talking about the parts they know really well, and about how > amazing it > > >> > would be if we had this resource on youtube. It would be the > ultimate > > >> form > > >> > of documentation by the foremost experts on aspects OCaml, welcoming > > >> > programmers to contribute to the OCaml compiler in the easiest way > > >> possible. > > >> > > > >> > A step further would be if this was done on Twitch or some similar > live > > >> > broadcasting platform, so people could actually ask live questions > as > > >> the > > >> > session took place. The resulting video would be posted to youtube. > > >> > > > >> > What do you guys think? > > >> > > > >> > -Yotam > > >> > > >> I would watch that. > > >> > > >> MfG > > >> Goswin > > >> > > >> -- > > >> Caml-list mailing list. Subscription management and archives: > > >> https://sympa.inria.fr/sympa/arc/caml-list > > >> Beginner's list: http://groups.yahoo.com/group/ocaml_beginners > > >> Bug reports: http://caml.inria.fr/bin/caml-bugs > > >> > > > > > > > > > > -- > > Caml-list mailing list. Subscription management and archives: > > https://sympa.inria.fr/sympa/arc/caml-list > > Beginner's list: http://groups.yahoo.com/group/ocaml_beginners > > Bug reports: http://caml.inria.fr/bin/caml-bugs > > -- > Caml-list mailing list. Subscription management and archives: > https://sympa.inria.fr/sympa/arc/caml-list > Beginner's list: http://groups.yahoo.com/group/ocaml_beginners > Bug reports: http://caml.inria.fr/bin/caml-bugs >