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