{"action":"created","issue":{"url":"https://api.github.com/repos/PowerShell/platyPS/issues/117","repository_url":"https://api.github.com/repos/PowerShell/platyPS","labels_url":"https://api.github.com/repos/PowerShell/platyPS/issues/117/labels{/name}","comments_url":"https://api.github.com/repos/PowerShell/platyPS/issues/117/comments","events_url":"https://api.github.com/repos/PowerShell/platyPS/issues/117/events","html_url":"https://github.com/PowerShell/platyPS/issues/117","id":158194702,"number":117,"title":"Plain text lists not migrated into markdown as lists.","user":{"login":"TimShererAtAquent","id":16466992,"avatar_url":"https://avatars.githubusercontent.com/u/16466992?v=3","gravatar_id":"","url":"https://api.github.com/users/TimShererAtAquent","html_url":"https://github.com/TimShererAtAquent","followers_url":"https://api.github.com/users/TimShererAtAquent/followers","following_url":"https://api.github.com/users/TimShererAtAquent/following{/other_user}","gists_url":"https://api.github.com/users/TimShererAtAquent/gists{/gist_id}","starred_url":"https://api.github.com/users/TimShererAtAquent/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/TimShererAtAquent/subscriptions","organizations_url":"https://api.github.com/users/TimShererAtAquent/orgs","repos_url":"https://api.github.com/users/TimShererAtAquent/repos","events_url":"https://api.github.com/users/TimShererAtAquent/events{/privacy}","received_events_url":"https://api.github.com/users/TimShererAtAquent/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":1,"created_at":"2016-06-02T17:21:37Z","updated_at":"2016-06-03T00:22:28Z","closed_at":null,"body":"\r\n![list cap 01](https://cloud.githubusercontent.com/assets/16466992/15754382/cc392860-28ac-11e6-9b0e-6dcd0c7fcf83.PNG)\r\n![list cap 02](https://cloud.githubusercontent.com/assets/16466992/15754383/cc3968b6-28ac-11e6-99e7-eb74484f06ee.PNG)\r\n\r\nPlaintext formatting for lists in the maml files is not migrated to MD files in a useful way. The way that we do PowerShell lists is as follows:\r\n\r\n\r\nIntroductory text:[linebreak][linebreak]\r\n[hyphen][hyphen][space]list item[linebreak]\r\n[hyphen][hyphen][space]list item[linebreak]\r\n[hyphen][hyphen][space]list item[linebreak][linebreak]\r\n\r\nThese appear in the MarkDown as follows: (Example from Get-Help.md)\r\n\r\n**The full view of help \\(-Full\\) includes a table of information about the parameters.\r\nThe table includes the following fields:\r\n\r\n-- Required:  Indicates whether the parameter is required \\(true\\) or optional \\(false\\).\r\n-- Position:  Indicates whether the parameter is named or positional \\(numbered\\). Positional parameters must appear in a specified place in the command.\r\n-- \"Named\" indicates that the parameter name is required, but that the parameter can appear anywhere in the command.\r\n-- \\<Number\\> indicates that the parameter name is optional, but when the name is omitted, the parameter must be in the place specified by the number. For example, \"2\" indicates that when the parameter name is omitted, the parameter must be the second \\(2\\) or only unnamed parameter in the command. When the parameter name is used, the parameter can appear anywhere in the command.\r\n-- Default value: The parameter value that Windows PowerShell uses if you do not include the parameter in the command.**\r\n\r\nResults in my atom editor preview window:\r\n**The full view of help (-Full) includes a table of information about the parameters. The table includes the following fields:\r\n-- Required: Indicates whether the parameter is required (true) or optional (false). -- Position: Indicates whether the parameter is named or positional (numbered). Positional parameters must appear in a specified place in the command. -- \"Named\" indicates that the parameter name is required, but that the parameter can appear anywhere in the command. -- \\ indicates that the parameter name is optional, but when the name is omitted, the parameter must be in the place specified by the number. For example, \"2\" indicates that when the parameter name is omitted, the parameter must be the second (2) or only unnamed parameter in the command. When the parameter name is used, the parameter can appear anywhere in the command. -- Default value: The parameter value that Windows PowerShell uses if you do not include the parameter in the command.**\r\n\r\nWe need to round-trip these, preferably turning out plaintext format into a simple markdown unordered list. For genuine round tripping, the simple markdown unordered list should be translated into the current list format in the maml file.\r\n\r\n\r\n"},"comment":{"url":"https://api.github.com/repos/PowerShell/platyPS/issues/comments/223460277","html_url":"https://github.com/PowerShell/platyPS/issues/117#issuecomment-223460277","issue_url":"https://api.github.com/repos/PowerShell/platyPS/issues/117","id":223460277,"user":{"login":"vors","id":816680,"avatar_url":"https://avatars.githubusercontent.com/u/816680?v=3","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":"2016-06-03T00:22:28Z","updated_at":"2016-06-03T00:22:28Z","body":"I agree that we should produce a valid markdown for lists, from existing MAML list patterns.\r\nThat means, we should transform `-- ` lists into `- ` or `* ` lists.\r\n\r\nHowever, I would argue that we should not try to do the round-trip: convert markdown lists into MAML lists (essentially it's a plain-text, so `- ` should do just fine as a list item mark).\r\nSuch growing logic in the MAML transformation would add complexity and make transformations less straightforward."}}
{"actor":{"display_login":"vors"}}