Improve existing documentation and add documentation for grace period