Re: [MirageOS-devel] How to implement protocols?

[Richard Mortier <richard.mortier@xxxxxxxxxxxx>]

On 13 November 2015 at 11:00, Daniel BÃnzli <daniel.buenzli@xxxxxxxxxxxx> wrote:
> Other than that the document feels like unstructured, poorly written [1], 
> random rumblings.
...
>
> [1] E.g. "A fundamental feature of functional programming is that 
> communication between functions is done via arguments and result values 
> solely."
>

Your relationship with Hannes might mean he doesn't consider that
comment rude, but in any case, I thought it might be helpful to put
down some thoughts on giving feedback on writing as "... the document
feels like unstructured, poorly written, random rumblings" achieves
nothing useful, and that probably means that your time reviewing the
thing has been wasted :)

+ Be specific -- eg., "the link between sections 1 and 2 wasn't clear".

+ Be constructive -- eg., "how about splitting section 3 in two
subsections titled X and Y" or "you need to add something about topic
Z".

+ Be useful -- eg., patches are generally better than criticism,
however specific and constructive!

More generally, as this community (hopefully!) continues to grow,
http://sarah.thesharps.us/2015/10/06/what-makes-a-good-community/
might be a worthwhile read.

Cheers,

-- 
Richard Mortier
richard.mortier@xxxxxxxxxxxx

_______________________________________________
MirageOS-devel mailing list
MirageOS-devel@xxxxxxxxxxxxxxxxxxxx
http://lists.xenproject.org/cgi-bin/mailman/listinfo/mirageos-devel