Data.List documentation improvements

Neil Mitchell ndmitchell at gmail.com
Sun Dec 3 19:20:13 EST 2006


Hi

> The deadline is Wednesday, December 6th.

That's incredibly soon, two days is just not enough time to do
anything! I recommend a minimum deadline of a week for anything, some
people may only catch up with their Haskell mail a couple of times a
week.

As for your patch, I think its great, and its exactly the type of
thing that should be in the libraries documentation for pretty much
everything. My only suggestion would be to include the "corner" cases:

take 3 [1] = [1]
drop 3 [1] = []

(ditto splitAt)

i.e. show that they produce a result, not an error.

Thanks

Neil


>
> ----- Original Message ----
> From: Andriy Palamarchuk <apa3a at yahoo.com>
> To: libraries at haskell.org
> Sent: Friday, December 1, 2006 9:53:08 PM
> Subject: Data.List documentation improvements
>
> Goal of my changes it to make list functions more accessible to Haskell newcomers.
> "Extracting sublists" section seems to have less complete documentation than rest of the module.
>
> Added examples for all the functions.
> Added easier to understand summaries for composite functions.
>
> Comments, suggestions, better descriptions?
>
> Is it Ok to send the darcs patches as is or it is better to send only diffs without context?
> I'd like to keep patch in plain text, not compressed.
>
> Thanks,
> Andriy
>
>
>
>
>
>
> ____________________________________________________________________________________
> Cheap talk?
> Check out Yahoo! Messenger's low PC-to-Phone call rates.
> http://voice.yahoo.com
> _______________________________________________
> Libraries mailing list
> Libraries at haskell.org
> http://www.haskell.org/mailman/listinfo/libraries
>


More information about the Libraries mailing list