<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
</head>
<body>
<p>My 2¢: my style comes from writing silly code and revisiting it
and realizing what to do differently. <br>
</p>
<p>I use stylish-haskell to order my import and I use hlint on my
code.<br>
<br>
I think compared to other languages, one writes more small
functions. And I rely more on haddock + type signatures - I've
learned some ways to avoid writing bad haddocks by getting
frustrated by packages on Hackage.<br>
<br>
Cheers,<br>
Vanessa McHale<br>
</p>
<div class="moz-cite-prefix">On 9/19/20 10:02 AM, Misja Alma wrote:<br>
</div>
<blockquote type="cite"
cite="mid:CAD0O6ZnxNVhNND7pt-=OwTSbe1kBSz_0GzsMeCA6ipGvzzti=w@mail.gmail.com">
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
<div dir="ltr">Hi,
<div><br>
</div>
<div>I have been writing Haskell in my spare time for a couple
of years now, but when I showed some code lately to a friend
he remarked that he didn't find it very readable. Actually I
agree, when I look at my own code of a couple of months old I
have trouble figuring out too what exactly it is doing.</div>
<div><br>
</div>
<div>I'm coming from a Java and Scala background and there,
especially for Java, are some generally accepted best
practices that make sure that your teammates don't have too
much trouble reading your code. E.g. write short functions
with a single responsibility, use variable, class and function
names that explain what they are meant for, etc.</div>
<div><br>
</div>
<div>I think some of those best practices, like short functions
with single responsibility, are useful for Haskell as well.
But Haskell is a different language than Java and has its own
strong points and pitfalls regarding readability, so it
probably needs different coding standards as well.</div>
<div><br>
</div>
<div>I have been looking on the Internet if I could find some
tips about improving readability but all I could find was <a
href="http://www.haskellforall.com/" moz-do-not-send="true">http://www.haskellforall.com/</a>.
Although there are some useful tips in there, this site seems
to be aimed at making Haskell easier to read for newcomers
from other languages. What I am interested in are tips from
real projects that are built by real teams.</div>
<div>Does anybody have any tips, or are there some sites or
books that I could read about this topic?</div>
<div><br>
</div>
<div>Thanks,</div>
<div>Misja</div>
<div><br>
</div>
</div>
<br>
<fieldset class="mimeAttachmentHeader"></fieldset>
<pre class="moz-quote-pre" wrap="">_______________________________________________
Haskell-Cafe mailing list
To (un)subscribe, modify options or view archives go to:
<a class="moz-txt-link-freetext" href="http://mail.haskell.org/cgi-bin/mailman/listinfo/haskell-cafe">http://mail.haskell.org/cgi-bin/mailman/listinfo/haskell-cafe</a>
Only members subscribed via the mailman list are allowed to post.</pre>
</blockquote>
</body>
</html>