Perhaps you should add a ``.. warning::`` or ``.. note::`` here to indicate that these parameters *may* be disappearing in favor of a location object.  Better to give that warning as early as possible, and we can always remove it again if we opt not to do that.