formatted API and readme