Editorial: Improve consistency of referring to String values

[gibson042]

This leaves a few cases of the String value *"…"* where it seems important to highlight that the value is a string (and most consistently in sections defining the initial value of a @@toStringTag property), but otherwise updates to just *"…"*. There is also some minor cleanup of operation descriptions in the neighborhood of those changes, for CanonicalNumericIndexString and Atomics.wait.

[bakkot]

Suggested change

	<p>Puts the calling agent in a wait queue and suspends it until notified or the wait times out, returning a String differentiating those cases. The following steps are taken:</p>
	<p>`Atomics.wait` puts the calling agent in a wait queue and suspends it until notified or the wait times out, returning a String differentiating those cases. The following steps are taken:</p>

We don't normally use sentence fragments in this position, I don't think? We're inconsistent in the terminology here, but I don't think we have that particular inconsistency, at least not often.

Also I prefer "until it is notified" rather than "until notified", since it makes explicit which thing is being notified.

[gibson042]

Sentence fragments here are not uncommon (there are lots of examples like <p>Returns … and <p>Performs … and <p>Produces …, cf. Number.prototype.toLocaleString/BigInt.prototype.toLocaleString and Math and String.prototype.matchAll and String.prototype.split and RegExp.prototype.exec ( string ) and Array.prototype.concat and %TypedArray%.prototype.subarray, with honorable mentions for Bitwise Shift Operators and String.prototype.charCodeAt/String.prototype.codePointAt [in which it is part of a note]).

But I actually share your grammatical preference, and don't remember my motivation here so I have accepted your suggestions. And in the long run, I expect this to be resolved by introducing more structure so the phrasing will become almost moot.

[jmdyck]

Sentence fragments here are not _un_common (there are lots of examples like <p>Returns … and <p>Performs … and <p>Produces …,

(Commit c6ca25f of PR #2592 changes these by inserting "This function" or "This method".)

[gibson042]

Thanks @jmdyck, I fully support the efforts of #2592. @bakkot Should I pull forward and merge its changes here?

Suggested change

	<p>Puts the calling agent in a wait queue and suspends it until notified or the wait times out, returning a String differentiating those cases. The following steps are taken:</p>
	<p>This function puts the calling agent in a wait queue and suspends it until it is notified or the wait times out, returning a String differentiating those cases.</p>
	<p>It performs the following steps when called:</p>

[bakkot]

Should I pull forward and merge its changes here?

Ehhh that seems pretty unrelated. I'd prefer not to try to tweak wording piecemeal; better for each PR to do its own thing.

[bakkot]

LGTM other than comments.

[syg]

While not grammatically wrong, I don't think, I'd prefer "... and suspends it until notified or until the wait times out", i.e. duplicating the "until", which I think reads better.

[michaelficarra]

Rebased and accepted @syg's suggestion. Should be ready to merge now.