updated docs of stats with new API