docs:  add mention of index swapping

Backpatch to 9.3

Greg Smith