The README will contain the old and the new API.  Do you think it is unnecessary to keep both?