[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

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

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

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

More generally, as this community (hopefully!) continues to grow,
might be a worthwhile read.


Richard Mortier

MirageOS-devel mailing list



Lists.xenproject.org is hosted with RackSpace, monitoring our
servers 24x7x365 and backed by RackSpace's Fanatical Support®.