Highlight importance of using single-quotes.

[jeffret-b]

Increase the documented visibility of the recommendation to use single quotes whenever possible.

[jeffret-b]

@Wadeck, does this look like what you want?

[Wadeck]

We have agreed to add a link to an article with details about password masking that could be broken depending on the content of the variables due to double quotes. This article is not yet written / up-to-date.

So this PR without the expected links (in both readme and help) has low value as there is no explanation about why ("complications" is not enough in this particularly difficult topic).

Do you expect the article to be a new one or a rewamp of an existing one?

[jeffret-b]

Do you expect the article to be a new one or a revamp of an existing one?

I expect it to be a new one. There really isn't an existing one that it makes sense to revamp.

We could make that new document a blog post -- that format would make it easier to get something out more quickly, even if it's later followed up by more polished documentation.

[Wadeck]

Feedback provided in https://cloudbees.atlassian.net/browse/JENSEC-1069 (CloudBees internal ticket)

[jglick]

jenkinsci/workflow-cps-plugin#370 by @car-roll will probably help more.

[jeffret-b]

jenkinsci/workflow-cps-plugin#370 by @car-roll will probably help more.

Yes, I agree with that.

[jeffret-b]

I updated this per Jesse's review comments, but it still needs coordination with other changes. It should be considered on hold for now.