Updated the documentation for client implementors.

More examples, some corresctions, ...