updating docs to support ranking feature