[Haskell-cafe] Best to not go there...

[David Feuer]

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.

On Sat, Sep 18, 2021, 3:30 AM Tom Ellis <
tom-lists-haskell-cafe-2017 at jaguarpaw.co.uk> wrote:

> On Sat, Sep 18, 2021 at 02:03:11AM -0400, Viktor Dukhovni wrote:
> > On Sat, Sep 18, 2021 at 03:35:29PM +1200, Anthony Clayden wrote:
> > > In fact it's deliberate that the docos are exclusionary. As part of
> > > this grand plan, Viktor is deliberately making the Libraries docos
> > > impenetrable. (By which I mean: the style is clear, but the material
> > > is unlearnable. Apparently I need to know what is an endomorphism
> > > before I can write a Foldable instance)
> >
> > I believe I'm owed an apology.  The above is inappropriate snark that
> > does not belong on this forum.  If we start finger pointing at people
> > driving away participation, perhaps a look in the mirror is warranted.
>
> Fully agreed.  Base has lacked important documentation for *years*.
> Anyone could have volunteered to improve it during those years but no
> one did.  In the end it was Viktor who made the effort.  He deserves
> our thanks and support and constructive suggestions for futher
> improvements.  Thanks Viktor!  Here's to continued collaborative
> improvement of our ecosystem.
>
> > If you'd like to write some text from a more approachable perspective
> > that augments or replaces the current text, by all means open an MR in
> > gitlab, and if it does a better job, I'll be among those cheering for it
> > to be merged.
>
> Indeed.
>
> Tom
> _______________________________________________
> Haskell-Cafe mailing list
> To (un)subscribe, modify options or view archives go to:
> http://mail.haskell.org/cgi-bin/mailman/listinfo/haskell-cafe
> Only members subscribed via the mailman list are allowed to post.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.haskell.org/pipermail/haskell-cafe/attachments/20210918/c6d53215/attachment.html>