On Mon, Mar 14, 2016 at 4:31 PM, Hendrik Boom <hendrik@topoi.pooq.com> 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