you need to update the scaladoc also
I wonder if someone relies on what is documented? Could it change ordering expectations?