Document Deployments drift remediation

[kramhuber]

Problem description

We offer remediation as an option in Deployments, but we don't describe what will take place with remediation happens. We should document it.

Existing remediation docs
Slack convo