adding docs changes for new overloaded order function