Add example of a nowdoc/heredoc as a function parameter about per-coding-style

[TimWolla]

Likewise there is no actual example of the correct format for a multi-line array (or anon function) within a multi-line parameter list. It just says that those do not imply that the parameter list itself is multi-line.

[KorvinSzanto]

I'd argue that:

Instead, the heredoc MUST be indented once past the indentation of the scope it's declared in.

makes it clear that your first example is allowed and your second example is disallowed.

[TimWolla]

I don't think it's clear, otherwise I wouldn't have opened this issue. Especially since a function call does not open a new scope if using common terminology (in PHP it's even arguable if if opens a new scope). Also the nowdoc/heredoc section is the only section where the term “scope” appears.

Certainly another explicit example can't hurt?

[TimWolla]

Alternatively this could be rephrased entirely:

"The heredoc body and ending delimiter must be indented one additional level compared to the opening delimiter"

[KorvinSzanto]

"Scope" here refers to the indentation scope, not the variable scope. I wouldn't mind adding another example if you want to open a PR.