add some comments to API mocks