platyPS
platyPS copied to clipboard
Error handling links to other commands
These are really "see also" links in the sense that there isn't a link per se, just a reference to related commands. For instance, look at the bottom of full help on Get-Process. You'll see "Stop-Process" but it isn't a link with Get-Help displaying the topic.
Steps to reproduce
Create comment-based help with something like this for .LINK:
.LINK
New-PlasterManifest
Test-PlasterManifest
Expected behavior
New-MarkdownHelp would not fail.
Actual behavior
I get this error:
At C:\Users\Keith\Documents\WindowsPowerShell\Modules\platyPS\0.7.2\platyPS.psm1:1221 char:17
+ $markdown | ForEach-Object {
+ ~~~~~~~~~~~~~~~~ [<<==>>] Exception: Exception calling "NodeModelToMamlModel" with "1" argument(s): "143:618 '[New-PlasterManifest
Test-PlasterManifest]()
' Expect hyperlink, but got [New-PlasterManifest Test-PlasterManifest]()" --> 143:618 '[New-PlasterManifest
Test-PlasterManifest]()
' Expect hyperlink, but got [New-PlasterManifest Test-PlasterManifest]()
I believe it is because it created this markdown for my links above:
## RELATED LINKS
[New-PlasterManifest
Test-PlasterManifest]()
Environment data
v0.7.2
Related to #250
Related to #283
Related to #138
@vors another hot topic to look at.
Related to #261
This is by design. The LINKS section expects links.