Expand all contractions except those used as examples.

[Nigel-Ecma]

Fixes #1596

While the “vote” on 1596 is 100% for this, it is hardly representative! ;-) However there is a meeting shortly so I’m clearing my desk and pushing this out.

[Nigel-Ecma]

Note that since #1596 I found one case where a contraction is used as an example, see lexical-structure.md lines 1439 & 1444, so a simple F&R addition to Smarten to do this automatically wouldn’t be so simple and likely fragile (if it looked for the exception). When I first wrote Smarten I did consider whether a “don’t smarten” tag might be needed in the text on occasions, I decided not at the time… Maybe checking for stray contractions will need to be a pre-publishing manual check.

[jskeet]

Upvoted 1596, and these changes look good to me.

[jskeet]

Any reason not to update the example as well? For the example you've given, I think we could easily change the message.

One place which could be tricky is where we've taken text from other documentation, e.g. in the standard library. It looks like this PR doesn't change any of those files - is that because there were no changes to make, or because you excluded them from your F&R?

[BillWagner]

This LGTM as well.

[Nigel-Ecma]

@jskeet wrote:

Any reason not to update the example as well? For the example you've given, I think we could easily change the message.

Reason: I was just trying to fix the language and not overload the PR ;-)

One place which could be tricky is where we've taken text from other documentation, e.g. in the standard library. It looks like this PR doesn't change any of those files - is that because there were no changes to make, or because you excluded them from your F&R?

They were not excluded. I did consider excluding text in comments, as they might be seen as informal, but decided against it. I suggest an attributed in-text quote should remain true to the source, but would not be concerned over text we derive from library documentation as we invariably edit that anyway.