updating docs to add ranking support