more documentation on core api