Move all `should` related docs to its own page.
Update docs to use expect syntax.
Tweak documentation to read better.
Merge pull request #225 from gautamkpai/should

Move `should` related stuff to separate page & update docs to use `expect`