added commenting on new api usage.