Allow deployments to correctly indicate they are failing to deploy

[smarterclayton]

Feature Description

• One-line feature description (can be used as a release note): Allow deployments to correctly indicate they are failing to deploy
• Primary contact (assignee): @Kargakis
• Responsible SIGs: @kubernetes/sig-apps-proposals
• Design proposal link: https://kubernetes.io/docs/concepts/workloads/controllers/deployment/#failed-deployment
• Reviewer(s) - (for LGTM) recommend having 2+ reviewers (at least one from code-area OWNERS file) agreed to review. Reviewers from multiple companies preferred: @janetkuo @smarterclayton
• Approver (likely from SIG/area to which feature belongs): @smarterclayton
• Feature target (which target equals to which milestone):
  • Beta release target (1.5)
  • Stable release target (1.6)

[0xmichalis]

@kubernetes/docs kubernetes/website#1699 is the docs PR for this.

[idvoretskyi]

@smarterclayton can you confirm that this item targets stable in 1.6?