[prev in list] [next in list] [prev in thread] [next in thread] 

List:       haskell-cafe
Subject:    Re: [Haskell-cafe] Announcing the Haskell Error Index
From:       David Christiansen via Haskell-Cafe <haskell-cafe () haskell ! org>
Date:       2022-10-21 17:36:29
Message-ID: CAK7U1=3G9RBmNdiBf1==hu0dMT_DSzgUFi2AG+2+1OT0aN2BYg () mail ! gmail ! com
[Download RAW message or body]

[Attachment #2 (multipart/alternative)]


Hi Olaf,


> the Haskell error index is an awesome idea and the existing entries of
> high quality.
>

Thanks! I hope it ends up being useful.


> Are there plans to tap the already quite enormous online resources
> about GHC errors, e.g. this mailing list, reddit and stackoverflow? One
> can imagine there are numerous brilliant explanations to be found.


I wouldn't feel comfortable taking somebody else's explanations, unless the
author wanted to contribute them. But links from the error index to good
explanations elsewhere on the Web are certainly welcome as part of the
documentation.


> How did the other languages you mentioned handle the initial
> populatuion with content? (A general problem knowledge bases suffer: To
> be useful, a critical mass of knowledge must be accumulated, otherwise
> users won't be likely to contribute.)
>

I think that the PHP community started with hand-written API documentation
like most other languages have, and then attached a comment section with
quality moderation that attracted good additional information from PHP
users. I don't know who wrote the information in the Rust error index, but
given that its texts are shorter, I suspect that it was someone working on
the compiler docs as a whole anyway. That site doesn't have a user-driven
section, from what I could see, though perhaps there's somewhere to send
PRs.

David

[Attachment #5 (text/html)]

<div dir="ltr"><div dir="ltr">Hi Olaf,</div><div class="gmail_quote"><div>  \
</div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px \
solid rgb(204,204,204);padding-left:1ex">the Haskell error index is an awesome idea \
and the existing entries of<br> high quality.  \
<br></blockquote><div><br></div><div>Thanks! I hope it ends up being \
useful.</div><div>  </div><blockquote class="gmail_quote" style="margin:0px 0px 0px \
0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"> Are there plans to \
tap the already quite enormous online resources<br> about GHC errors, e.g. this \
mailing list, reddit and stackoverflow? One<br> can imagine there are numerous \
brilliant explanations to be found.</blockquote><div><br></div><div>I wouldn&#39;t \
feel comfortable taking somebody else&#39;s explanations, unless the author wanted to \
contribute them. But links from the error index to good explanations elsewhere on the \
Web are certainly welcome as part of the documentation.</div><div>  </div><blockquote \
class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid \
rgb(204,204,204);padding-left:1ex">How did the other languages you mentioned handle \
the initial<br> populatuion with content? (A general problem knowledge bases suffer: \
To<br> be useful, a critical mass of knowledge must be accumulated, otherwise<br>
users won&#39;t be likely to contribute.)<br></blockquote><div><br></div><div>I think \
that the PHP community started with hand-written API documentation like most other \
languages have, and then attached a comment section with quality moderation that \
attracted good additional information from PHP users. I don&#39;t know who wrote the \
information in the Rust error index, but given that its texts are shorter, I suspect \
that it was someone working on the compiler docs as a whole anyway. That site \
doesn&#39;t have a user-driven section, from what I could see, though perhaps \
there&#39;s somewhere to send PRs.</div><div>  </div><div>David</div></div></div>


[Attachment #6 (text/plain)]

_______________________________________________
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.

[prev in list] [next in list] [prev in thread] [next in thread]