Enhance public API docs for 2.0

Some things done for beta1 already but there is clean up and expansion needed still.

Both the C++ and QML API docs need to be brought up to Qt standards.