Further updates to API Documentation

Some clean up and proofing of the API doc. Fixed several technical
errors, some re-ordering.