[Haskell-beginners] general observation about programming

Dudley Brooks dbrooks at runforyourlife.org
Thu Feb 25 16:17:45 UTC 2016


Ages and ages ago I saw this advice about programming:

Q:  "What's the best language for a programmer to know?"

A:  "English" (or whatever your native language is)

-- Dudley

On 2/24/16 4:03 PM, Dennis Raddle wrote:

> This is more about programming in general than Haskell, although 
> Haskellers probably know it well.
>
> I don't claim to have expert knowledge on this, but I'm gradually 
> getting better at it.
>
> When I set out to write a program, or refactor a program, or modify a 
> program, it helps to set out my thinking in a clear way. And how I 
> make it clear is to document my thoughts.
>
> An outline is one good way to organize thoughts and is probably my 
> main tool. But good English prose is also helpful.
>
> The key factor is "editing." In what sense do I mean that? Good 
> writers do it, and the Haskell documentation does it. I mean (1) 
> brevity and (2) good flow. To achieve brevity, you must think about 
> the essence of each statement and trim away the unnecessary stuff. 
> Good flow refers to how the document builds up and modifies your 
> concepts as you read it. A document can actually mirror an effective 
> learning process, or influence and change your process.
>
> I work with my documentation, making several editing passes. By the 
> time I'm done, I am in a great position to write a concise and 
> flexible program.
>
> It's interesting that not only is Haskell a concise language, but the 
> Haskell library documentation is concise. Contrast that with the 
> Python documentation which often wanders about into areas that are 
> irrelevant--it could easily be cut into one third its present size.
>
> Mike
>
>
>
>
> _______________________________________________
> Beginners mailing list
> Beginners at haskell.org
> http://mail.haskell.org/cgi-bin/mailman/listinfo/beginners

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.haskell.org/pipermail/beginners/attachments/20160225/f9d82223/attachment.html>


More information about the Beginners mailing list