Add source/demos target to doc Makefile
Add user documentation of solve interface

First stab with examples for solving and assembling linear and
non-linear systems along with a little bit on debugging convergence
failures.
Link solving docs into documentation page