{"action":"created","issue":{"url":"https://api.github.com/repos/apiaryio/drafter/issues/125","labels_url":"https://api.github.com/repos/apiaryio/drafter/issues/125/labels{/name}","comments_url":"https://api.github.com/repos/apiaryio/drafter/issues/125/comments","events_url":"https://api.github.com/repos/apiaryio/drafter/issues/125/events","html_url":"https://github.com/apiaryio/drafter/issues/125","id":108484461,"number":125,"title":"The curious tale of underscores (parsing preference error, usability bug or spec oversight)","user":{"login":"Almad","id":44565,"avatar_url":"https://avatars.githubusercontent.com/u/44565?v=3","gravatar_id":"","url":"https://api.github.com/users/Almad","html_url":"https://github.com/Almad","followers_url":"https://api.github.com/users/Almad/followers","following_url":"https://api.github.com/users/Almad/following{/other_user}","gists_url":"https://api.github.com/users/Almad/gists{/gist_id}","starred_url":"https://api.github.com/users/Almad/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/Almad/subscriptions","organizations_url":"https://api.github.com/users/Almad/orgs","repos_url":"https://api.github.com/users/Almad/repos","events_url":"https://api.github.com/users/Almad/events{/privacy}","received_events_url":"https://api.github.com/users/Almad/received_events","type":"User","site_admin":false},"labels":[],"state":"closed","locked":false,"assignee":null,"milestone":null,"comments":3,"created_at":"2015-09-26T18:05:17Z","updated_at":"2015-10-05T12:06:25Z","closed_at":"2015-09-28T17:44:13Z","body":"Imagine a need to describe a parameter like this one:\r\n\r\n```\r\n+ underscore_param: `default_underscorevalue` (string) - This is parameter that uses underscore_values\r\n```\r\n\r\nthat can be in either payload or URL parameter.\r\n\r\nUnfortunately, Markdown's preference to treat \\_text between underscore as italic\\_ probably takes preference over standard parsing rules, messing the resulting AST.\r\n\r\nI think this is a bug that should be fixed.\r\n\r\n## (Missing) Workarounds\r\n\r\nWhen using as MSON in `Attributes` section, the workaround is to put `underscore_param` into backticks:\r\n\r\n```\r\n+ Attributes\r\n    + `underscore_param`: `default_underscorevalue` (string) - This is parameter that uses underscore_values\r\n```\r\n\r\nThis produces expected result. \r\n\r\nUnfortunately, in `Parameters` section, enclosing parameter name into backticks causes the parameter line to be ignored. Therefore, to my knowledge, there is currently no way to describe a parameter that contains `_` in both parameter name and default value. \r\n"},"comment":{"url":"https://api.github.com/repos/apiaryio/drafter/issues/comments/145507140","html_url":"https://github.com/apiaryio/drafter/issues/125#issuecomment-145507140","issue_url":"https://api.github.com/repos/apiaryio/drafter/issues/125","id":145507140,"user":{"login":"Almad","id":44565,"avatar_url":"https://avatars.githubusercontent.com/u/44565?v=3","gravatar_id":"","url":"https://api.github.com/users/Almad","html_url":"https://github.com/Almad","followers_url":"https://api.github.com/users/Almad/followers","following_url":"https://api.github.com/users/Almad/following{/other_user}","gists_url":"https://api.github.com/users/Almad/gists{/gist_id}","starred_url":"https://api.github.com/users/Almad/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/Almad/subscriptions","organizations_url":"https://api.github.com/users/Almad/orgs","repos_url":"https://api.github.com/users/Almad/repos","events_url":"https://api.github.com/users/Almad/events{/privacy}","received_events_url":"https://api.github.com/users/Almad/received_events","type":"User","site_admin":false},"created_at":"2015-10-05T12:06:25Z","updated_at":"2015-10-05T12:06:25Z","body":"> Actually, underscore is a reserved character in MSON.\r\n\r\nBut it is behaving differently than other reserved characters like dash; if I add dash, the whole line is not valid at all—while underscore is invalid only in specific circumstances. "}}