{"action":"created","issue":{"url":"https://api.github.com/repos/tldr-pages/tldr/issues/289","labels_url":"https://api.github.com/repos/tldr-pages/tldr/issues/289/labels{/name}","comments_url":"https://api.github.com/repos/tldr-pages/tldr/issues/289/comments","events_url":"https://api.github.com/repos/tldr-pages/tldr/issues/289/events","html_url":"https://github.com/tldr-pages/tldr/pull/289","id":100135402,"number":289,"title":"reword to prevent ambiguity","user":{"login":"waldyrious","id":478237,"avatar_url":"https://avatars.githubusercontent.com/u/478237?v=3","gravatar_id":"","url":"https://api.github.com/users/waldyrious","html_url":"https://github.com/waldyrious","followers_url":"https://api.github.com/users/waldyrious/followers","following_url":"https://api.github.com/users/waldyrious/following{/other_user}","gists_url":"https://api.github.com/users/waldyrious/gists{/gist_id}","starred_url":"https://api.github.com/users/waldyrious/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/waldyrious/subscriptions","organizations_url":"https://api.github.com/users/waldyrious/orgs","repos_url":"https://api.github.com/users/waldyrious/repos","events_url":"https://api.github.com/users/waldyrious/events{/privacy}","received_events_url":"https://api.github.com/users/waldyrious/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":4,"created_at":"2015-08-10T18:23:46Z","updated_at":"2015-08-11T01:26:29Z","closed_at":null,"pull_request":{"url":"https://api.github.com/repos/tldr-pages/tldr/pulls/289","html_url":"https://github.com/tldr-pages/tldr/pull/289","diff_url":"https://github.com/tldr-pages/tldr/pull/289.diff","patch_url":"https://github.com/tldr-pages/tldr/pull/289.patch"},"body":"\"original\" can be associated with the origin of the link and lead to confusion if not read carefully. Using \"target\" instead prevents this ambiguity.\r\n\r\nBtw, the third example seems to have been copied from the prior example but not fully adapted: \"original/file\" should have said (if I'm reading this correctly) \"original/folder\".\r\n\r\nAlso, I removed `/file` from the \"file or folder\" examples, to make it more generic."},"comment":{"url":"https://api.github.com/repos/tldr-pages/tldr/issues/comments/129663696","html_url":"https://github.com/tldr-pages/tldr/pull/289#issuecomment-129663696","issue_url":"https://api.github.com/repos/tldr-pages/tldr/issues/289","id":129663696,"user":{"login":"waldyrious","id":478237,"avatar_url":"https://avatars.githubusercontent.com/u/478237?v=3","gravatar_id":"","url":"https://api.github.com/users/waldyrious","html_url":"https://github.com/waldyrious","followers_url":"https://api.github.com/users/waldyrious/followers","following_url":"https://api.github.com/users/waldyrious/following{/other_user}","gists_url":"https://api.github.com/users/waldyrious/gists{/gist_id}","starred_url":"https://api.github.com/users/waldyrious/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/waldyrious/subscriptions","organizations_url":"https://api.github.com/users/waldyrious/orgs","repos_url":"https://api.github.com/users/waldyrious/repos","events_url":"https://api.github.com/users/waldyrious/events{/privacy}","received_events_url":"https://api.github.com/users/waldyrious/received_events","type":"User","site_admin":false},"created_at":"2015-08-11T01:26:29Z","updated_at":"2015-08-11T01:26:29Z","body":"I suppose the simplest and clearest is `ln from to`.\r\n\r\nIMO \"source/destination\", \"origin/target\" and \"here/there\" would be bad options, for the reasons @rprieto pointed out.\r\n\r\nAs for \"actual file\", I dunno, I guess it works but somehow feels a somewhat hacky way to deal with this issue. I don't know why :smile: I just don't like it a lot.\r\n"}}