remove descending and include docs and define second parameter