improving comment for secrets

[haydonryan]

Thanks for contributing to pcf-pipelines. To speed up the process of reviewing your pull request please provide us with:

• A short explanation of the proposed change: Improving docs for secret.

[pivotal-issuemaster]

@haydonryan Please sign the Contributor License Agreement!

Click here to manually synchronize the status of this Pull Request.

See the FAQ for frequently asked questions.

[cf-gitbot]

We have created an issue in Pivotal Tracker to manage this. Unfortunately, the Pivotal Tracker project is private so you may be unable to view the contents of the story.

The labels on this github issue will be updated when the story is started.

[pivotal-issuemaster]

@haydonryan Thank you for signing the Contributor License Agreement!