readme: example and api docs.