update README to indicate this has old and new API doc
more updates