- ``multi-relocate`` or ``multi-evacuate``. The ``allocate`` request
- is used when a new instance needs to be placed on the cluster. The
- ``relocate`` request is used when an existing instance needs to be
- 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.
+ ``change-group`` or ``node-evacuate``. The
+ ``allocate`` request is used when a new instance needs to be placed
+ on the cluster. The ``relocate`` request is used when an existing
+ instance needs to be 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 needs only be
+ implemented if backwards compatibility with Ganeti 2.4 and lower is
+ needed.
+
+ 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>`.
+
+ The ``multi-allocate`` request is used to allocate multiple
+ instances on the cluster. The request is beside of that very
+ similiar to the ``allocate`` one. For more details look at
+ :doc:`Ganeti bulk create <design-bulk-create>`.