{"action":"created","issue":{"url":"https://api.github.com/repos/PowerShell/platyPS/issues/363","repository_url":"https://api.github.com/repos/PowerShell/platyPS","labels_url":"https://api.github.com/repos/PowerShell/platyPS/issues/363/labels{/name}","comments_url":"https://api.github.com/repos/PowerShell/platyPS/issues/363/comments","events_url":"https://api.github.com/repos/PowerShell/platyPS/issues/363/events","html_url":"https://github.com/PowerShell/platyPS/issues/363","id":329042179,"node_id":"MDU6SXNzdWUzMjkwNDIxNzk=","number":363,"title":"Syntax sections notation intermittent issue","user":{"login":"BernieWhite","id":13513058,"node_id":"MDQ6VXNlcjEzNTEzMDU4","avatar_url":"https://avatars0.githubusercontent.com/u/13513058?v=4","gravatar_id":"","url":"https://api.github.com/users/BernieWhite","html_url":"https://github.com/BernieWhite","followers_url":"https://api.github.com/users/BernieWhite/followers","following_url":"https://api.github.com/users/BernieWhite/following{/other_user}","gists_url":"https://api.github.com/users/BernieWhite/gists{/gist_id}","starred_url":"https://api.github.com/users/BernieWhite/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/BernieWhite/subscriptions","organizations_url":"https://api.github.com/users/BernieWhite/orgs","repos_url":"https://api.github.com/users/BernieWhite/repos","events_url":"https://api.github.com/users/BernieWhite/events{/privacy}","received_events_url":"https://api.github.com/users/BernieWhite/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"assignees":[],"milestone":null,"comments":1,"created_at":"2018-06-04T12:52:10Z","updated_at":"2018-06-06T07:11:14Z","closed_at":null,"author_association":"CONTRIBUTOR","body":"Ok possibly I've gone mad here, or there is a default behaviour of the PowerShell engine that is unexpected. But closely inspecting the parameters of functions in platyPS I'm not convinced that mandatory and positional/named parameters are correctly represented. The behaviour seems inconsistent.\r\n\r\nI would expect `-Path` to use the form `-Path <String[]>` in `Update-MarkdownHelp` because it is mandatory and not flagged as positional. Likewise I would expect `Encoding` and `LogPath` to not use `[]` around the parameter name indicating positional form. But then `-Session` is correct.\r\n\r\nSteps to reproduce\r\n------------------\r\nUpdate module docs .i.e. `Update-MarkdownHelp .\\docs\\`.\r\n\r\nExpected behavior\r\n-----------------\r\n\r\n```\r\nUpdate-MarkdownHelp -Path <String[]> [-Encoding <Encoding>] [-LogPath <String>] [-LogAppend] [-AlphabeticParamsOrder] [-UseFullTypeName] [-Session <PSSession>] [<CommonParameters>]\r\n```\r\n\r\nActual behavior\r\n---------------\r\n\r\n```\r\nUpdate-MarkdownHelp [-Path] <String[]> [[-Encoding] <Encoding>] [[-LogPath] <String>] [-LogAppend]\r\n [-AlphabeticParamsOrder] [-UseFullTypeName] [-Session <PSSession>] [<CommonParameters>]\r\n```\r\n\r\nEnvironment data\r\n----------------\r\n\r\nv0.9.0, master\r\n"},"comment":{"url":"https://api.github.com/repos/PowerShell/platyPS/issues/comments/394964638","html_url":"https://github.com/PowerShell/platyPS/issues/363#issuecomment-394964638","issue_url":"https://api.github.com/repos/PowerShell/platyPS/issues/363","id":394964638,"node_id":"MDEyOklzc3VlQ29tbWVudDM5NDk2NDYzOA==","user":{"login":"vors","id":816680,"node_id":"MDQ6VXNlcjgxNjY4MA==","avatar_url":"https://avatars0.githubusercontent.com/u/816680?v=4","gravatar_id":"","url":"https://api.github.com/users/vors","html_url":"https://github.com/vors","followers_url":"https://api.github.com/users/vors/followers","following_url":"https://api.github.com/users/vors/following{/other_user}","gists_url":"https://api.github.com/users/vors/gists{/gist_id}","starred_url":"https://api.github.com/users/vors/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/vors/subscriptions","organizations_url":"https://api.github.com/users/vors/orgs","repos_url":"https://api.github.com/users/vors/repos","events_url":"https://api.github.com/users/vors/events{/privacy}","received_events_url":"https://api.github.com/users/vors/received_events","type":"User","site_admin":false},"created_at":"2018-06-06T07:11:14Z","updated_at":"2018-06-06T07:11:14Z","author_association":"COLLABORATOR","body":"Can you help me understand it better with some minimal repro? Is it help engine problem or platyPS?"}}
{"actor":{"display_login":"vors"}}