docs: machinepool contract spec

This adds documentation that details the contract for providers when
implementing an infrastructure machine pool.

This has been created retrospectively from looking at a number of
providers and the MachinePool controller.

Signed-off-by: Richard Case <[email protected]>

Author: richardcase