expanding on the last couple of sections

Tidied up some code samples too.

cc @paulcbetts to give it his blessing
Dependency doesn't need to be a RaiseAndSetIfChanged property because it is read-only