Karen Etheridge wrote:
> Rick Measham wrote:
>> DateTime's strength is it's rigid adherence to being Correct. If you say 
>> there's a duration of 2 days, we don't assume you mean 48 hours as there 
>> could be a DST jump in that 2 days. The representation of data is 
>> handled by the ::Format:: classes -- including 
>> DateTime::Format::Duration which is aimed at formatting durations in a 
>> manner that makes sense to the user of the module.
>
> Perhaps the real bug here is in documentation... there's rarely a case
> where there can be *too much* documentation. :)  The DateTime suite is
> huge, so it can be challenging sometimes finding the right interface to
> DWIM, while not knowing what terms to search for. So, more cross-indexing
> between the main documentation pages might help: e.g. "if you want to do
> this, see this section on this page..." etc.
>
> tl;dr: I'm sure documentation patches to add such references would be
> gratefully accepted.

There *is* a FAQ page: http://datetime.perl.org/?FAQ.

I think it's fair to say the FAQ page would benefit a lot from some exapansion 
and modernization. It seems not to have in it some of the questions that are 
frequently asked here.

Jim Monty

Reply via email to