Correct basic usage example; improve API assumptions section