Improve existing documentation and add one for grace period