Relations reordering beta

docs/user-docs/latest/content-manager/managing-relational-fields.md

@@ -54,7 +54,7 @@ You can click on the name of the selected entry to be redirected to the edit vie
 
 To remove the entry selected in the drop-down list, click on the delete button ![Clear icon](../assets/icons/clear.svg).
 
-## Managing multiple-choices relational fields
+## Managing multiple-choice relational fields
 
 Many-to-many, one-to-many, and many-ways types of relation allow to choose several entries per relational field.
 
@@ -70,4 +70,6 @@ To select the relevant relational field's entries:
 All selected entries are listed right below the drop-down list. Click on the name of an entry to be redirected to the edit view of the relational field's content-type. Make sure you save your page first, to avoid losing your last modifications.
 :::
 
-To remove an entry, click on the remove button ![Minus icon](../assets/icons/minus.svg) in the selected entries list.
+To remove an entry, click on the cross button ![Cross icon](../assets/icons/cross.svg) in the selected entries list.
+
+Entries from multiple-choice relational fields can be reordered, indicated by a drag button ![Drag icon](../assets/icons/drag.svg). To move an entry, click and hold it, drag it to the desired position, then release it.

docs/user-docs/latest/content-manager/writing-content.md

@@ -90,9 +90,13 @@ Dynamic zones are a combination of components, which themselves are composed of
 
 Dynamic zones' components can also be reordered or deleted directly in the edit view, using buttons displayed in the top right corner of the component area.
 
-- Use the arrow buttons ![Up icon](../assets/icons/up2.svg) ![Down icon](../assets/icons/down2.svg) to reorder components in your dynamic zone.
+- Use the drag & drop button ![Drag icon](../assets/icons/drag.svg) to reorder components in your dynamic zone.
 - Use the delete button ![Delete icon](../assets/icons/delete.svg) to delete a component from your dynamic zone.
 
+:::tip
+You can also use the keyboard to reorder components: focus the component using Tab, press Space on the drag & drop button ![Drag icon](../assets/icons/drag.svg) and use the arrow keys to then re-order, pressing Space again to drop the item.
+:::
+
 ::: note
 Unlike regular fields, the order of the fields and components inside a dynamic field is important. It should correspond exactly to how end users will read/see the content.
 :::