docs; Date method caveats

closes #1598
website; regen