{"action":"created","issue":{"url":"https://api.github.com/repos/campoy/embedmd/issues/11","repository_url":"https://api.github.com/repos/campoy/embedmd","labels_url":"https://api.github.com/repos/campoy/embedmd/issues/11/labels{/name}","comments_url":"https://api.github.com/repos/campoy/embedmd/issues/11/comments","events_url":"https://api.github.com/repos/campoy/embedmd/issues/11/events","html_url":"https://github.com/campoy/embedmd/issues/11","id":164614500,"number":11,"title":"Clarify path separator used in filename in the spec.","user":{"login":"shurcooL","id":1924134,"avatar_url":"https://avatars.githubusercontent.com/u/1924134?v=3","gravatar_id":"","url":"https://api.github.com/users/shurcooL","html_url":"https://github.com/shurcooL","followers_url":"https://api.github.com/users/shurcooL/followers","following_url":"https://api.github.com/users/shurcooL/following{/other_user}","gists_url":"https://api.github.com/users/shurcooL/gists{/gist_id}","starred_url":"https://api.github.com/users/shurcooL/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/shurcooL/subscriptions","organizations_url":"https://api.github.com/users/shurcooL/orgs","repos_url":"https://api.github.com/users/shurcooL/repos","events_url":"https://api.github.com/users/shurcooL/events{/privacy}","received_events_url":"https://api.github.com/users/shurcooL/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"assignees":[],"milestone":null,"comments":1,"created_at":"2016-07-08T20:54:14Z","updated_at":"2016-10-29T04:44:03Z","closed_at":null,"body":"The `embedmd` command is currently specified/documented as:\r\n\r\n> The format of an embedmd command is:\r\n>\r\n>     [embedmd]:# (filename language /start regexp/ /end regexp/)\r\n>\r\n> The embedded code will be extracted from the file filename, starting at the first line that matches /start regexp/ and finishing at the first line matching /end regexp/.\r\n\r\nThis is underspecified, and I have the following questions about the filename:\r\n\r\n- Can the filename refer to a file inside a directory? If so, what should the path separator be used? Would it be the OS-specific path separator, such as `\\` on Windows or `/` on Linux? Or would it always be slash (`/`) separated like URLs are, no matter what OS you're on?\r\n- Are absolute paths supported too, or only relative paths?\r\n\r\nSo, if I have a file `hello.go` in a subfolder `code`, which of these should I write if I'm on Windows:\r\n\r\n```Markdown\r\n[embedmd]:# (code/hello.go /package.*/)\r\n```\r\n\r\n```Markdown\r\n[embedmd]:# (code\\hello.go /package.*/)\r\n```\r\n\r\nOr is it invalid/unsupported to have the hello.go file inside a subfolder?\r\n\r\nI think resolving this issue is a prerequisite for resolving #10.\r\n\r\nAlso, in case it's not obvious, I really hope you choose to go with always `/`-separated paths, because that's the only way Markdown documents written on any OS would be compatible/interchangeable."},"comment":{"url":"https://api.github.com/repos/campoy/embedmd/issues/comments/257070730","html_url":"https://github.com/campoy/embedmd/issues/11#issuecomment-257070730","issue_url":"https://api.github.com/repos/campoy/embedmd/issues/11","id":257070730,"user":{"login":"shurcooL","id":1924134,"avatar_url":"https://avatars.githubusercontent.com/u/1924134?v=3","gravatar_id":"","url":"https://api.github.com/users/shurcooL","html_url":"https://github.com/shurcooL","followers_url":"https://api.github.com/users/shurcooL/followers","following_url":"https://api.github.com/users/shurcooL/following{/other_user}","gists_url":"https://api.github.com/users/shurcooL/gists{/gist_id}","starred_url":"https://api.github.com/users/shurcooL/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/shurcooL/subscriptions","organizations_url":"https://api.github.com/users/shurcooL/orgs","repos_url":"https://api.github.com/users/shurcooL/repos","events_url":"https://api.github.com/users/shurcooL/events{/privacy}","received_events_url":"https://api.github.com/users/shurcooL/received_events","type":"User","site_admin":false},"created_at":"2016-10-29T04:44:03Z","updated_at":"2016-10-29T04:44:03Z","body":"Friendly ping. I'll just quote the TLDR of the issue here, just in case that's helpful:\r\n\r\n> Also, in case it's not obvious, I really hope you choose to go with always `/`-separated paths, because that's the only way Markdown documents written on any OS would be compatible/interchangeable."}}
{"actor":{"display_login":"shurcooL"}}