edge case around dates - updated documentation