Add some documentation for the RestartPolicy feature.

Signed-off-by: Jean-Paul Calderone <jean-paul@clusterhq.com>
Merge pull request #8073 from ClusterHQ/7743-restart-policy-api-doc

Add some documentation for the RestartPolicy feature.