relates to #192
updated examples for things changed so far in 3.0
resolves #205: links to new documentation