clearer README; add README to api folder