Improve existing docs
Add docs for the grace period
Merge pull request #3 from scorphus/master

Improve existing documentation and add documentation for grace period