clean up README

move API documentation out (now in streamer-spec repo), fix some links