Merge-MarkdownHelp expectation when parameter type varies across versions?

Inizia con il file platyPSIssue3.zip fornito e riproduci Merge-MarkdownHelp usando le quattro directory di Exchange Server e i file New-MailboxImportRequest.md. Esamina l'output unito per il parametro Mailbox e la sezione SYNTAX; il lavoro è completo quando esiste un risultato documentato e coerente per i diversi valori di Type, set di parametri e valori di Applicable tra le versioni.

I wouldn't necessarily call this a bug, but what is the expected Merge-MarkdownHelp result if the Type value of the same parameter in the same cmdlet changes from one version of the product to another (e.g., Exchange 2013 to Exchange 2016)?

For example, the Mailbox parameter in the New-MailboxImportRequest cmdlet. In Exchange 2010 and Exchange 2013, the Type value is MailboxOrMailUserIdParameter. In Exchange 2016 and Exchange 2019, the Type value is MailboxLocationIdParameter. The actual description portions of the parameter is the same across versions.

If you create the following folder structure with the appropriate files:

\Exchange Server 2010\New-MailboxImportRequest.md
\Exchange Server 2013\New-MailboxImportRequest.md
\Exchange Server 2016\New-MailboxImportRequest.md
\Exchange Server 2019\New-MailboxImportRequest.md

And then run the following commands:

$x = "<path>\Exchange Server 2010","<path>\Exchange Server 2013","<path>\Exchange Server 2016","<path>\Exchange Server 2019"
Merge-MarkdownHelp -Path $x -OutputPath "<path>\platyPSissue\Merged" -ExplicitApplicableIfAll

platyPSIssue3.zip

You'll see in the resulting attached output file, the Type value of the Mailbox parameter is MailboxOrMailUserIdParameter only (the 2010/2013 values). Shouldn't the Mailbox parameter contain multiple YAML sections like this?

Type: MailboxOrMailUserIdParameter
Parameter Sets: (All)
Aliases:
Applicable: Exchange Server 2010, Exchange Server 2013

Required: True
Position: 1
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False

Type: MailboxLocationIdParameter
Parameter Sets: (All)
Aliases:
Applicable: Exchange Server 2016, Exchange Server 2019

Required: True
Position: 1
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False

And what about parameter sets in the SYNTAX section? As you can see, the Mailbox parameter only has the MailboxOrMailUserId parameter:

## SYNTAX

New-MailboxImportRequest [-Mailbox] <MailboxOrMailUserIdParameter> ...

Shouldn't there be two parameter sets? And what to call them and/or how to duplicate and tack and identifier on the end of the parameter set name like this?

## SYNTAX

### MailboxOrMailUserId

New-MailboxImportRequest [-Mailbox] <MailboxOrMailUserIdParameter> ...

### MailboxLocationId

New-MailboxImportRequest [-Mailbox] <MailboxLocationIdParameter> ...

And of course, this would change the Applicable values in the YAML sections in the parameter description.

Is this known or expected behavior?