In Section 7.4 (Removing Nodes from the Overcloud) here: http://file.bne.redhat.com/~dmacpher/OpenStack/7.0/Director/#sect-Removing_Nodes The documentation should mention that operators ought to manually migrate any active workloads off of a compute node before removing it from the overcloud stack. The procedure for doing so is already documented in section 7.5 (7.5. Replacing Compute Nodes), but it needs to be referenced here.
Assigning to Dan for review.
This content is live on the Customer Portal. Closing.