Generate placeholder for SYNOPSIS, instead of duplicate of SYNTAX

[vors]

Currently, we use output of Get-Help to generate SYNOPSIS and don't distinguish between a custom one and help-engine generated one.

We should make it a placeholder, if it's not present to avoid confusion and make bootstrap experience better.

[jongeller]

@vors
So, are you saying we generate a new header called Synopsis if none exists and leave it with a note saying 'To Be Filled'?

Can you provide the example where you saw this?

[vors]

No, I'm saying we should do this. Currently we are putting duplicate of SYNTAX, because help engine generates defaul SYNOPSIS as duplicate of SYNTAX and we just using it.

[jongeller]

How about this for the look:

Update-MarkdownHelp

SYNOPSIS

{{ Add a synopsis here. }}

SYNTAX

Update-MarkdownHelp [-Path] <String[]> [[-Encoding] <Encoding>] [[-LogPath] <String>] [-LogAppend]
 [<CommonParameters>]

[vors]

Fixed per c5ac385