Online Version implementation

[TimShererAtAquent]

All topics, for instance, Add-History under Related Links –

The Online Version link appears in the Related Links section. According to the PowerShell spec, the -Online switch works by redirecting to the first URL in the Related Topics section. This was handled behind the scenes in Dx, assuring that the first was the link in the list of links.

If people add related topics to the cmdlet in markdown, and if they add them at the top, the -Online switch will go to their new link, not the intended one.

We need to store the online link in the markdown metadata. PlatyPS could check the metadata against the links in the related section (per discussion in today's meeting). If somebody does add a new link over the current links, the MD > MAML conversion could move it back to being first.

(There is also a colon after the words Online Version, which looks bad. I don't know whether it's required by the PS engine, since it appears in the spec.)

[vors]

Ah, thank you for the explanation Tim!
I didn't realise that Get-Help -Online looks for the first link. I though it looks for Online Version: key. Now it start makes more sense. I think it would be best to move it into metadata, indeed.

[gerane]

Nice to know! I need to correct this in a module I'm getting close to publishing.

[vors]

Fixed in 00c99ac

[vors]

Forgot to add corresponding logic in markdown generator

[vors]

Second part fixed via 6534fe3