[Haskell-cafe] Data.Time

[Daniel Schüssler]

On 2011-June-27 Monday 10:15:28 Yitzchak Gale wrote:
> The biggest shortcoming, in my opinion, is that the documentation
> assumes that the reader is very familiar with the Haskell type
> system, and with viewing type signatures and instance lists as an
> integral and central part of the documentation.
> 
> In particular, Haskell's standard numeric type classes and the
> conversion functions between them play a central role in the API
> of Data.Time.

Making use of Haddock's recently added(?) support for comments on instance 
declaration would help a lot here, I think (even if it was just to draw 
attention to the Num/Integral/Real/Fractional instances).

 > Before you undertake writing a whole new time library, why not
> try writing some improved documentation for Data.Time first?

I got the impression that Tony's issue with Data.Time was the lack of some 
feature, not usability. Seems like the details that were omitted for the sake 
of constructiveness are quite relevant :)

Cheers,
Daniel