docs; Date method caveats

closes #1598