{"action":"created","issue":{"url":"https://api.github.com/repos/elixir-lang/elixir/issues/3779","labels_url":"https://api.github.com/repos/elixir-lang/elixir/issues/3779/labels{/name}","comments_url":"https://api.github.com/repos/elixir-lang/elixir/issues/3779/comments","events_url":"https://api.github.com/repos/elixir-lang/elixir/issues/3779/events","html_url":"https://github.com/elixir-lang/elixir/pull/3779","id":108493399,"number":3779,"title":"Remove external links in summary and update docs for Port.","user":{"login":"deansc","id":2566077,"avatar_url":"https://avatars.githubusercontent.com/u/2566077?v=3","gravatar_id":"","url":"https://api.github.com/users/deansc","html_url":"https://github.com/deansc","followers_url":"https://api.github.com/users/deansc/followers","following_url":"https://api.github.com/users/deansc/following{/other_user}","gists_url":"https://api.github.com/users/deansc/gists{/gist_id}","starred_url":"https://api.github.com/users/deansc/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/deansc/subscriptions","organizations_url":"https://api.github.com/users/deansc/orgs","repos_url":"https://api.github.com/users/deansc/repos","events_url":"https://api.github.com/users/deansc/events{/privacy}","received_events_url":"https://api.github.com/users/deansc/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":2,"created_at":"2015-09-26T20:21:12Z","updated_at":"2015-09-27T02:26:53Z","closed_at":null,"pull_request":{"url":"https://api.github.com/repos/elixir-lang/elixir/pulls/3779","html_url":"https://github.com/elixir-lang/elixir/pull/3779","diff_url":"https://github.com/elixir-lang/elixir/pull/3779.diff","patch_url":"https://github.com/elixir-lang/elixir/pull/3779.patch"},"body":"This is a fix for the open issue #3688 .\r\n\r\nI tried to follow all the suggestions discussed in the thread (especially rephrasing the sentences from the Erlang doc)."},"comment":{"url":"https://api.github.com/repos/elixir-lang/elixir/issues/comments/143513412","html_url":"https://github.com/elixir-lang/elixir/pull/3779#issuecomment-143513412","issue_url":"https://api.github.com/repos/elixir-lang/elixir/issues/3779","id":143513412,"user":{"login":"eksperimental","id":9133420,"avatar_url":"https://avatars.githubusercontent.com/u/9133420?v=3","gravatar_id":"","url":"https://api.github.com/users/eksperimental","html_url":"https://github.com/eksperimental","followers_url":"https://api.github.com/users/eksperimental/followers","following_url":"https://api.github.com/users/eksperimental/following{/other_user}","gists_url":"https://api.github.com/users/eksperimental/gists{/gist_id}","starred_url":"https://api.github.com/users/eksperimental/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/eksperimental/subscriptions","organizations_url":"https://api.github.com/users/eksperimental/orgs","repos_url":"https://api.github.com/users/eksperimental/repos","events_url":"https://api.github.com/users/eksperimental/events{/privacy}","received_events_url":"https://api.github.com/users/eksperimental/received_events","type":"User","site_admin":false},"created_at":"2015-09-27T02:26:53Z","updated_at":"2015-09-27T02:26:53Z","body":"hi @deansc,\r\nthanks for looking after this.\r\n\r\nI would finish all the \"For more information...\" sentences with a trailing period.\r\n\r\n\"Inlined by the compiler\" is usually the last sentence. in the docs. so I would place it there as well.  just to keep it consistent with the rest of the docs.\r\n\r\nWe need to use backticks for every reference to a variable. for example in: \r\n> Associates the port identifier with a pid. \r\nit should read\r\n> Associates the `port` identifier with a `pid`.\r\n\r\nI would just use the name of the variable to refer to something that is obvious, for example (I know there could be cases where it's good to be explicit, so take it with a grain of salt.)\r\n> Closes the port `port`.\r\nI would rewrite it as:\r\n> Closes the `port`.\r\n\r\nI will read the docs, and give you more feedback.\r\nthanks again"}}