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