Add some documentation for the RestartPolicy feature.

Fixes #7743

I didn't manage to figure out how the API is versioned. My guess is that this functionality applies to 1.14/1.15... but just a guess. I can adjust this if that's incorrect. Just let me know how one would figure out which version of the API is associated with which version of Docker.

(Fixed version of code previously submitted as #8071)