More documentation work

Added some examples for the new methods and options, fixed a couple of
links