document add_partial_residuals()

update reference output for examples

update example reference output

add an error msg

add some examples to partial_residuals (#76) and update the example outputs

link to issues correctly