more comments on the API overview