<div dir="auto">I should have said earlier that while I disagree with Viktor about typeclass laws, I'm very much in favor of his goal of making the documentation more approachable.</div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Sat, Sep 18, 2021, 3:30 AM Tom Ellis <<a href="mailto:tom-lists-haskell-cafe-2017@jaguarpaw.co.uk">tom-lists-haskell-cafe-2017@jaguarpaw.co.uk</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">On Sat, Sep 18, 2021 at 02:03:11AM -0400, Viktor Dukhovni wrote:<br>
> On Sat, Sep 18, 2021 at 03:35:29PM +1200, Anthony Clayden wrote:<br>
> > In fact it's deliberate that the docos are exclusionary. As part of<br>
> > this grand plan, Viktor is deliberately making the Libraries docos<br>
> > impenetrable. (By which I mean: the style is clear, but the material<br>
> > is unlearnable. Apparently I need to know what is an endomorphism<br>
> > before I can write a Foldable instance)<br>
> <br>
> I believe I'm owed an apology.  The above is inappropriate snark that<br>
> does not belong on this forum.  If we start finger pointing at people<br>
> driving away participation, perhaps a look in the mirror is warranted.<br>
<br>
Fully agreed.  Base has lacked important documentation for *years*.<br>
Anyone could have volunteered to improve it during those years but no<br>
one did.  In the end it was Viktor who made the effort.  He deserves<br>
our thanks and support and constructive suggestions for futher<br>
improvements.  Thanks Viktor!  Here's to continued collaborative<br>
improvement of our ecosystem.<br>
<br>
> If you'd like to write some text from a more approachable perspective<br>
> that augments or replaces the current text, by all means open an MR in<br>
> gitlab, and if it does a better job, I'll be among those cheering for it<br>
> to be merged.<br>
<br>
Indeed.<br>
<br>
Tom<br>
_______________________________________________<br>
Haskell-Cafe mailing list<br>
To (un)subscribe, modify options or view archives go to:<br>
<a href="http://mail.haskell.org/cgi-bin/mailman/listinfo/haskell-cafe" rel="noreferrer noreferrer" target="_blank">http://mail.haskell.org/cgi-bin/mailman/listinfo/haskell-cafe</a><br>
Only members subscribed via the mailman list are allowed to post.</blockquote></div>