improve readme (adds api examples and goals)