Update API.

added more information about the general outline of the API.