add better docs for recreate pods

[tejal29]

Relates to #2877

Description

Add better docs for recreatePods and mention thy are used in helm upgrade to upgrade a chart.

User facing changes

yes

Before

on master https://skaffold.dev/docs/references/yaml/

recreatePods: false | # | if true, Skaffold will send --recreate-pods flag to Helm CLI.

After

recreatePods: false | # |  if `true`, Skaffold will send `--recreate-pods` flag to Helm CLI
  when upgrading a new version of a chart in subsequent dev loop deploy.

Next PRs.

In this section describe a list of follow up PRs if the current PR is a part of big feature change.

See example #2811

Write n/a if not applicable.

Submitter Checklist

These are the criteria that every PR should meet, please check them off as you
review them:

• Includes unit tests
• Mentions any output changes.
• Adds documentation as needed: user docs, YAML reference, CLI reference.
• Adds integration tests if needed.

See the contribution guide for more details.

Double check this list of stuff that's easy to miss:

• If you are adding a example to the examples dir, please copy them to integration/examples
• Every new example added in integration/examples dir, should be tested in integration test

Reviewer Notes

• The code flow looks good.
• Unit test added.
• User facing changes look good.

Release Notes

Describe any user facing changes here so maintainer can include it in the release notes, or delete this block.

[container-tools-bot]

Please visit http://34.94.71.232:1313 to view changes to the docs.