Better API documentation.

Add an embryo of document at the API level describing
main classes and use cases.

Change-Id: I687a227a2e6c343e142bea515ff651d8a442771e