- moved within its node group, while the ``multi-relocate`` one is
- able to relocate multiple instances across multiple node groups. The
- ``multi-evacuate`` protocol requests that the script computes the
- optimal relocate solution for all secondary instances of the given
- nodes.
+ moved within its node group.
+
+ The ``multi-evacuate`` protocol used to request that the script
+ computes the optimal relocate solution for all secondary instances
+ of the given nodes. It is now deprecated and should no longer be
+ used.
+
+ The ``change-group`` request is used to relocate multiple instances
+ across multiple node groups. ``node-evacuate`` evacuates instances
+ off their node(s). These are described in a separate :ref:`design
+ document <multi-reloc-detailed-design>`.