{"action":"created","issue":{"url":"https://api.github.com/repos/JuliaLang/julia/issues/23763","repository_url":"https://api.github.com/repos/JuliaLang/julia","labels_url":"https://api.github.com/repos/JuliaLang/julia/issues/23763/labels{/name}","comments_url":"https://api.github.com/repos/JuliaLang/julia/issues/23763/comments","events_url":"https://api.github.com/repos/JuliaLang/julia/issues/23763/events","html_url":"https://github.com/JuliaLang/julia/issues/23763","id":258719920,"number":23763,"title":"Show similar functions in docstrings","user":{"login":"shorty66","id":10434328,"avatar_url":"https://avatars1.githubusercontent.com/u/10434328?v=4","gravatar_id":"","url":"https://api.github.com/users/shorty66","html_url":"https://github.com/shorty66","followers_url":"https://api.github.com/users/shorty66/followers","following_url":"https://api.github.com/users/shorty66/following{/other_user}","gists_url":"https://api.github.com/users/shorty66/gists{/gist_id}","starred_url":"https://api.github.com/users/shorty66/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/shorty66/subscriptions","organizations_url":"https://api.github.com/users/shorty66/orgs","repos_url":"https://api.github.com/users/shorty66/repos","events_url":"https://api.github.com/users/shorty66/events{/privacy}","received_events_url":"https://api.github.com/users/shorty66/received_events","type":"User","site_admin":false},"labels":[{"id":208968668,"url":"https://api.github.com/repos/JuliaLang/julia/labels/intro%20issue","name":"intro issue","color":"0052cc","default":false}],"state":"open","locked":false,"assignee":null,"assignees":[],"milestone":null,"comments":1,"created_at":"2017-09-19T07:20:06Z","updated_at":"2017-09-19T13:07:45Z","closed_at":null,"author_association":"CONTRIBUTOR","body":"I think discoverability would be greatly enhanced, if there would be some hints at similar functions in the docstrings.\r\nI imagine a line of `See also: ...function names...` which should be generated from a table of related functions automatically.\r\n\r\nThis came to my mind when looking at the docs of `pop!`. The functions `shift!` and `splice!` offer solutions to similar problems, but their names cannot be guessed from each other.\r\n\r\n```julia\r\npop!(collection, key[, default])\r\n\r\n  Delete and return the mapping for key if it exists in collection, otherwise return default, or\r\n  throw an error if default is not specified.\r\n\r\n[...]\r\n\r\nSee also: shift!(), splice!()\r\n```\r\n\r\nOf course, the wording is open for bike shedding 👍 "},"comment":{"url":"https://api.github.com/repos/JuliaLang/julia/issues/comments/330533132","html_url":"https://github.com/JuliaLang/julia/issues/23763#issuecomment-330533132","issue_url":"https://api.github.com/repos/JuliaLang/julia/issues/23763","id":330533132,"user":{"login":"nalimilan","id":1120448,"avatar_url":"https://avatars3.githubusercontent.com/u/1120448?v=4","gravatar_id":"","url":"https://api.github.com/users/nalimilan","html_url":"https://github.com/nalimilan","followers_url":"https://api.github.com/users/nalimilan/followers","following_url":"https://api.github.com/users/nalimilan/following{/other_user}","gists_url":"https://api.github.com/users/nalimilan/gists{/gist_id}","starred_url":"https://api.github.com/users/nalimilan/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/nalimilan/subscriptions","organizations_url":"https://api.github.com/users/nalimilan/orgs","repos_url":"https://api.github.com/users/nalimilan/repos","events_url":"https://api.github.com/users/nalimilan/events{/privacy}","received_events_url":"https://api.github.com/users/nalimilan/received_events","type":"User","site_admin":false},"created_at":"2017-09-19T13:07:45Z","updated_at":"2017-09-19T13:07:45Z","author_association":"CONTRIBUTOR","body":"That would be great. The manual could also be updated to suggest a standard wording for the section at https://docs.julialang.org/en/stable/manual/documentation/"}}
{"actor":{"display_login":"nalimilan"}}