{"action":"created","issue":{"url":"https://api.github.com/repos/JuliaLang/julia/issues/14525","labels_url":"https://api.github.com/repos/JuliaLang/julia/issues/14525/labels{/name}","comments_url":"https://api.github.com/repos/JuliaLang/julia/issues/14525/comments","events_url":"https://api.github.com/repos/JuliaLang/julia/issues/14525/events","html_url":"https://github.com/JuliaLang/julia/pull/14525","id":124517676,"number":14525,"title":"Improve parallel computing documentation","user":{"login":"ahwillia","id":636625,"avatar_url":"https://avatars.githubusercontent.com/u/636625?v=3","gravatar_id":"","url":"https://api.github.com/users/ahwillia","html_url":"https://github.com/ahwillia","followers_url":"https://api.github.com/users/ahwillia/followers","following_url":"https://api.github.com/users/ahwillia/following{/other_user}","gists_url":"https://api.github.com/users/ahwillia/gists{/gist_id}","starred_url":"https://api.github.com/users/ahwillia/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ahwillia/subscriptions","organizations_url":"https://api.github.com/users/ahwillia/orgs","repos_url":"https://api.github.com/users/ahwillia/repos","events_url":"https://api.github.com/users/ahwillia/events{/privacy}","received_events_url":"https://api.github.com/users/ahwillia/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":1,"created_at":"2015-12-31T23:44:42Z","updated_at":"2016-01-01T01:24:45Z","closed_at":null,"pull_request":{"url":"https://api.github.com/repos/JuliaLang/julia/pulls/14525","html_url":"https://github.com/JuliaLang/julia/pull/14525","diff_url":"https://github.com/JuliaLang/julia/pull/14525.diff","patch_url":"https://github.com/JuliaLang/julia/pull/14525.patch"},"body":"I've been having a bit of a hard time teaching myself how to use Julia's parallel computing tools from the documentation. There are a couple open issues / pull requests to suggest I'm not alone:\r\n\r\n* https://github.com/JuliaLang/julia/issues/14312\r\n* https://github.com/JuliaLang/julia/pull/10277\r\n\r\nSo far, I've just rewritten the introductory bits of the parallel computing documentation. I am happy to iterate on this and write/re-write more sections if this is helpful.\r\n\r\nI tried to address the following issues (from my perspective) in the introductory sections:\r\n\r\n* There wasn't a discussion of basic commands like `nprocs`, `addprocs`, etc.\r\n* Technical terms `RemoteRef`, `Channel`, `RemoteChannel`, etc. are introduced without being explained. Several are explained later in the documentation, so removing these early mentions cleans things up.\r\n* I added two section headers to orient the readers"},"comment":{"url":"https://api.github.com/repos/JuliaLang/julia/issues/comments/168272843","html_url":"https://github.com/JuliaLang/julia/pull/14525#issuecomment-168272843","issue_url":"https://api.github.com/repos/JuliaLang/julia/issues/14525","id":168272843,"user":{"login":"ahwillia","id":636625,"avatar_url":"https://avatars.githubusercontent.com/u/636625?v=3","gravatar_id":"","url":"https://api.github.com/users/ahwillia","html_url":"https://github.com/ahwillia","followers_url":"https://api.github.com/users/ahwillia/followers","following_url":"https://api.github.com/users/ahwillia/following{/other_user}","gists_url":"https://api.github.com/users/ahwillia/gists{/gist_id}","starred_url":"https://api.github.com/users/ahwillia/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ahwillia/subscriptions","organizations_url":"https://api.github.com/users/ahwillia/orgs","repos_url":"https://api.github.com/users/ahwillia/repos","events_url":"https://api.github.com/users/ahwillia/events{/privacy}","received_events_url":"https://api.github.com/users/ahwillia/received_events","type":"User","site_admin":false},"created_at":"2016-01-01T01:24:45Z","updated_at":"2016-01-01T01:24:45Z","body":"Other potential improvements:\r\n\r\n* `require(\"count_heads\")` -- require is deprecated\r\n* `pmap()` example could be more explicit. `result = pmap(svd, M); U1,s1,Vt1 = result[1]`"}}