DOC: document time detector changes more thoroughly