{"action":"opened","number":358,"pull_request":{"url":"https://api.github.com/repos/haskell/network/pulls/358","id":233401033,"node_id":"MDExOlB1bGxSZXF1ZXN0MjMzNDAxMDMz","html_url":"https://github.com/haskell/network/pull/358","diff_url":"https://github.com/haskell/network/pull/358.diff","patch_url":"https://github.com/haskell/network/pull/358.patch","issue_url":"https://api.github.com/repos/haskell/network/issues/358","number":358,"state":"open","locked":false,"title":"Improve network package description","user":{"login":"eborden","id":545655,"node_id":"MDQ6VXNlcjU0NTY1NQ==","avatar_url":"https://avatars2.githubusercontent.com/u/545655?v=4","gravatar_id":"","url":"https://api.github.com/users/eborden","html_url":"https://github.com/eborden","followers_url":"https://api.github.com/users/eborden/followers","following_url":"https://api.github.com/users/eborden/following{/other_user}","gists_url":"https://api.github.com/users/eborden/gists{/gist_id}","starred_url":"https://api.github.com/users/eborden/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/eborden/subscriptions","organizations_url":"https://api.github.com/users/eborden/orgs","repos_url":"https://api.github.com/users/eborden/repos","events_url":"https://api.github.com/users/eborden/events{/privacy}","received_events_url":"https://api.github.com/users/eborden/received_events","type":"User","site_admin":false},"body":"Previous discussion: https://github.com/haskell/network/issues/343\r\n\r\nNetwork's existence as a low level wrapper around C apis has been well\r\nestablished and recently cemented with official deprecation of the\r\nNetwork module. This decision left a hole in the ecosystem that has been\r\nfilled by many downstream libraries. For most use cases network is far\r\ntoo low level and many higher level libraries are far more appropriate,\r\nyet network still has high traction and continues to draw users who are\r\nconfused or mystified by how low level the library is. Part of the\r\nproblem is the package's description on hackage.\r\n\r\n  This package provides a low-level networking interface.\r\n  .\r\n  In network-2.6 the @Network.URI@ module was split off into its own\r\n  package, network-uri-2.6. If you're using the @Network.URI@ module\r\n  you can automatically get it from the right package by adding this\r\n  to your .cabal file:\r\n  .\r\n  > library\r\n  > build-depends: network-uri-flag\r\n\r\nThis description leaves much to be desired. It only has a single\r\nsentence describing what network is and then spends much more detail in\r\npointing users to a historic package split. This description is a lost\r\nopportunity for the ecosystem. A reverse dependency lookup shows many\r\ndownstream consumers of network, but only a few of these are high level\r\nlibraries appropriate for most application developers. network could use\r\nits package description to highlight notable packages that are higher\r\nlevel and have easier ergonomics, such as the connection library. This\r\nwould provide a much simpler path for most users to leverage socket\r\nprogramming in Haskell.\r\n\r\nThrough disscussion 3 packages were identified as appropriate to\r\nenumerate:\r\n\r\n* connection\r\n* hookup\r\n* network simple\r\n\r\nThese packages follow the simple rule that they:\r\n\r\n* depend on network.\r\n* expose a subset of network's functionality.","created_at":"2018-11-25T21:12:04Z","updated_at":"2018-11-25T21:12:04Z","closed_at":null,"merged_at":null,"merge_commit_sha":null,"assignee":{"login":"eborden","id":545655,"node_id":"MDQ6VXNlcjU0NTY1NQ==","avatar_url":"https://avatars2.githubusercontent.com/u/545655?v=4","gravatar_id":"","url":"https://api.github.com/users/eborden","html_url":"https://github.com/eborden","followers_url":"https://api.github.com/users/eborden/followers","following_url":"https://api.github.com/users/eborden/following{/other_user}","gists_url":"https://api.github.com/users/eborden/gists{/gist_id}","starred_url":"https://api.github.com/users/eborden/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/eborden/subscriptions","organizations_url":"https://api.github.com/users/eborden/orgs","repos_url":"https://api.github.com/users/eborden/repos","events_url":"https://api.github.com/users/eborden/events{/privacy}","received_events_url":"https://api.github.com/users/eborden/received_events","type":"User","site_admin":false},"assignees":[{"login":"eborden","id":545655,"node_id":"MDQ6VXNlcjU0NTY1NQ==","avatar_url":"https://avatars2.githubusercontent.com/u/545655?v=4","gravatar_id":"","url":"https://api.github.com/users/eborden","html_url":"https://github.com/eborden","followers_url":"https://api.github.com/users/eborden/followers","following_url":"https://api.github.com/users/eborden/following{/other_user}","gists_url":"https://api.github.com/users/eborden/gists{/gist_id}","starred_url":"https://api.github.com/users/eborden/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/eborden/subscriptions","organizations_url":"https://api.github.com/users/eborden/orgs","repos_url":"https://api.github.com/users/eborden/repos","events_url":"https://api.github.com/users/eborden/events{/privacy}","received_events_url":"https://api.github.com/users/eborden/received_events","type":"User","site_admin":false}],"requested_reviewers":[],"requested_teams":[],"labels":[{"id":275529458,"node_id":"MDU6TGFiZWwyNzU1Mjk0NTg=","url":"https://api.github.com/repos/haskell/network/labels/documentation","name":"documentation","color":"009800","default":false}],"milestone":null,"commits_url":"https://api.github.com/repos/haskell/network/pulls/358/commits","review_comments_url":"https://api.github.com/repos/haskell/network/pulls/358/comments","review_comment_url":"https://api.github.com/repos/haskell/network/pulls/comments{/number}","comments_url":"https://api.github.com/repos/haskell/network/issues/358/comments","statuses_url":"https://api.github.com/repos/haskell/network/statuses/8586f4325e5e080274ebbc1c26090fe54624b3f7","head":{"label":"haskell:improve-description","ref":"improve-description","sha":"8586f4325e5e080274ebbc1c26090fe54624b3f7","user":{"login":"haskell","id":450574,"node_id":"MDEyOk9yZ2FuaXphdGlvbjQ1MDU3NA==","avatar_url":"https://avatars1.githubusercontent.com/u/450574?v=4","gravatar_id":"","url":"https://api.github.com/users/haskell","html_url":"https://github.com/haskell","followers_url":"https://api.github.com/users/haskell/followers","following_url":"https://api.github.com/users/haskell/following{/other_user}","gists_url":"https://api.github.com/users/haskell/gists{/gist_id}","starred_url":"https://api.github.com/users/haskell/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/haskell/subscriptions","organizations_url":"https://api.github.com/users/haskell/orgs","repos_url":"https://api.github.com/users/haskell/repos","events_url":"https://api.github.com/users/haskell/events{/privacy}","received_events_url":"https://api.github.com/users/haskell/received_events","type":"Organization","site_admin":false},"repo":{"id":1030046,"node_id":"MDEwOlJlcG9zaXRvcnkxMDMwMDQ2","name":"network","full_name":"haskell/network","private":false,"owner":{"login":"haskell","id":450574,"node_id":"MDEyOk9yZ2FuaXphdGlvbjQ1MDU3NA==","avatar_url":"https://avatars1.githubusercontent.com/u/450574?v=4","gravatar_id":"","url":"https://api.github.com/users/haskell","html_url":"https://github.com/haskell","followers_url":"https://api.github.com/users/haskell/followers","following_url":"https://api.github.com/users/haskell/following{/other_user}","gists_url":"https://api.github.com/users/haskell/gists{/gist_id}","starred_url":"https://api.github.com/users/haskell/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/haskell/subscriptions","organizations_url":"https://api.github.com/users/haskell/orgs","repos_url":"https://api.github.com/users/haskell/repos","events_url":"https://api.github.com/users/haskell/events{/privacy}","received_events_url":"https://api.github.com/users/haskell/received_events","type":"Organization","site_admin":false},"html_url":"https://github.com/haskell/network","description":"Low-level networking interface","fork":false,"url":"https://api.github.com/repos/haskell/network","forks_url":"https://api.github.com/repos/haskell/network/forks","keys_url":"https://api.github.com/repos/haskell/network/keys{/key_id}","collaborators_url":"https://api.github.com/repos/haskell/network/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/haskell/network/teams","hooks_url":"https://api.github.com/repos/haskell/network/hooks","issue_events_url":"https://api.github.com/repos/haskell/network/issues/events{/number}","events_url":"https://api.github.com/repos/haskell/network/events","assignees_url":"https://api.github.com/repos/haskell/network/assignees{/user}","branches_url":"https://api.github.com/repos/haskell/network/branches{/branch}","tags_url":"https://api.github.com/repos/haskell/network/tags","blobs_url":"https://api.github.com/repos/haskell/network/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/haskell/network/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/haskell/network/git/refs{/sha}","trees_url":"https://api.github.com/repos/haskell/network/git/trees{/sha}","statuses_url":"https://api.github.com/repos/haskell/network/statuses/{sha}","languages_url":"https://api.github.com/repos/haskell/network/languages","stargazers_url":"https://api.github.com/repos/haskell/network/stargazers","contributors_url":"https://api.github.com/repos/haskell/network/contributors","subscribers_url":"https://api.github.com/repos/haskell/network/subscribers","subscription_url":"https://api.github.com/repos/haskell/network/subscription","commits_url":"https://api.github.com/repos/haskell/network/commits{/sha}","git_commits_url":"https://api.github.com/repos/haskell/network/git/commits{/sha}","comments_url":"https://api.github.com/repos/haskell/network/comments{/number}","issue_comment_url":"https://api.github.com/repos/haskell/network/issues/comments{/number}","contents_url":"https://api.github.com/repos/haskell/network/contents/{+path}","compare_url":"https://api.github.com/repos/haskell/network/compare/{base}...{head}","merges_url":"https://api.github.com/repos/haskell/network/merges","archive_url":"https://api.github.com/repos/haskell/network/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/haskell/network/downloads","issues_url":"https://api.github.com/repos/haskell/network/issues{/number}","pulls_url":"https://api.github.com/repos/haskell/network/pulls{/number}","milestones_url":"https://api.github.com/repos/haskell/network/milestones{/number}","notifications_url":"https://api.github.com/repos/haskell/network/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/haskell/network/labels{/name}","releases_url":"https://api.github.com/repos/haskell/network/releases{/id}","deployments_url":"https://api.github.com/repos/haskell/network/deployments","created_at":"2010-10-27T21:37:32Z","updated_at":"2018-11-22T08:00:13Z","pushed_at":"2018-11-25T21:10:39Z","git_url":"git://github.com/haskell/network.git","ssh_url":"git@github.com:haskell/network.git","clone_url":"https://github.com/haskell/network.git","svn_url":"https://github.com/haskell/network","homepage":"","size":1481,"stargazers_count":185,"watchers_count":185,"language":"Haskell","has_issues":true,"has_projects":true,"has_downloads":true,"has_wiki":false,"has_pages":false,"forks_count":122,"mirror_url":null,"archived":false,"open_issues_count":15,"license":{"key":"other","name":"Other","spdx_id":"NOASSERTION","url":null,"node_id":"MDc6TGljZW5zZTA="},"forks":122,"open_issues":15,"watchers":185,"default_branch":"master"}},"base":{"label":"haskell:master","ref":"master","sha":"854bd756385648d0b3c6110398231a2dd0696306","user":{"login":"haskell","id":450574,"node_id":"MDEyOk9yZ2FuaXphdGlvbjQ1MDU3NA==","avatar_url":"https://avatars1.githubusercontent.com/u/450574?v=4","gravatar_id":"","url":"https://api.github.com/users/haskell","html_url":"https://github.com/haskell","followers_url":"https://api.github.com/users/haskell/followers","following_url":"https://api.github.com/users/haskell/following{/other_user}","gists_url":"https://api.github.com/users/haskell/gists{/gist_id}","starred_url":"https://api.github.com/users/haskell/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/haskell/subscriptions","organizations_url":"https://api.github.com/users/haskell/orgs","repos_url":"https://api.github.com/users/haskell/repos","events_url":"https://api.github.com/users/haskell/events{/privacy}","received_events_url":"https://api.github.com/users/haskell/received_events","type":"Organization","site_admin":false},"repo":{"id":1030046,"node_id":"MDEwOlJlcG9zaXRvcnkxMDMwMDQ2","name":"network","full_name":"haskell/network","private":false,"owner":{"login":"haskell","id":450574,"node_id":"MDEyOk9yZ2FuaXphdGlvbjQ1MDU3NA==","avatar_url":"https://avatars1.githubusercontent.com/u/450574?v=4","gravatar_id":"","url":"https://api.github.com/users/haskell","html_url":"https://github.com/haskell","followers_url":"https://api.github.com/users/haskell/followers","following_url":"https://api.github.com/users/haskell/following{/other_user}","gists_url":"https://api.github.com/users/haskell/gists{/gist_id}","starred_url":"https://api.github.com/users/haskell/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/haskell/subscriptions","organizations_url":"https://api.github.com/users/haskell/orgs","repos_url":"https://api.github.com/users/haskell/repos","events_url":"https://api.github.com/users/haskell/events{/privacy}","received_events_url":"https://api.github.com/users/haskell/received_events","type":"Organization","site_admin":false},"html_url":"https://github.com/haskell/network","description":"Low-level networking interface","fork":false,"url":"https://api.github.com/repos/haskell/network","forks_url":"https://api.github.com/repos/haskell/network/forks","keys_url":"https://api.github.com/repos/haskell/network/keys{/key_id}","collaborators_url":"https://api.github.com/repos/haskell/network/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/haskell/network/teams","hooks_url":"https://api.github.com/repos/haskell/network/hooks","issue_events_url":"https://api.github.com/repos/haskell/network/issues/events{/number}","events_url":"https://api.github.com/repos/haskell/network/events","assignees_url":"https://api.github.com/repos/haskell/network/assignees{/user}","branches_url":"https://api.github.com/repos/haskell/network/branches{/branch}","tags_url":"https://api.github.com/repos/haskell/network/tags","blobs_url":"https://api.github.com/repos/haskell/network/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/haskell/network/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/haskell/network/git/refs{/sha}","trees_url":"https://api.github.com/repos/haskell/network/git/trees{/sha}","statuses_url":"https://api.github.com/repos/haskell/network/statuses/{sha}","languages_url":"https://api.github.com/repos/haskell/network/languages","stargazers_url":"https://api.github.com/repos/haskell/network/stargazers","contributors_url":"https://api.github.com/repos/haskell/network/contributors","subscribers_url":"https://api.github.com/repos/haskell/network/subscribers","subscription_url":"https://api.github.com/repos/haskell/network/subscription","commits_url":"https://api.github.com/repos/haskell/network/commits{/sha}","git_commits_url":"https://api.github.com/repos/haskell/network/git/commits{/sha}","comments_url":"https://api.github.com/repos/haskell/network/comments{/number}","issue_comment_url":"https://api.github.com/repos/haskell/network/issues/comments{/number}","contents_url":"https://api.github.com/repos/haskell/network/contents/{+path}","compare_url":"https://api.github.com/repos/haskell/network/compare/{base}...{head}","merges_url":"https://api.github.com/repos/haskell/network/merges","archive_url":"https://api.github.com/repos/haskell/network/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/haskell/network/downloads","issues_url":"https://api.github.com/repos/haskell/network/issues{/number}","pulls_url":"https://api.github.com/repos/haskell/network/pulls{/number}","milestones_url":"https://api.github.com/repos/haskell/network/milestones{/number}","notifications_url":"https://api.github.com/repos/haskell/network/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/haskell/network/labels{/name}","releases_url":"https://api.github.com/repos/haskell/network/releases{/id}","deployments_url":"https://api.github.com/repos/haskell/network/deployments","created_at":"2010-10-27T21:37:32Z","updated_at":"2018-11-22T08:00:13Z","pushed_at":"2018-11-25T21:10:39Z","git_url":"git://github.com/haskell/network.git","ssh_url":"git@github.com:haskell/network.git","clone_url":"https://github.com/haskell/network.git","svn_url":"https://github.com/haskell/network","homepage":"","size":1481,"stargazers_count":185,"watchers_count":185,"language":"Haskell","has_issues":true,"has_projects":true,"has_downloads":true,"has_wiki":false,"has_pages":false,"forks_count":122,"mirror_url":null,"archived":false,"open_issues_count":15,"license":{"key":"other","name":"Other","spdx_id":"NOASSERTION","url":null,"node_id":"MDc6TGljZW5zZTA="},"forks":122,"open_issues":15,"watchers":185,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/haskell/network/pulls/358"},"html":{"href":"https://github.com/haskell/network/pull/358"},"issue":{"href":"https://api.github.com/repos/haskell/network/issues/358"},"comments":{"href":"https://api.github.com/repos/haskell/network/issues/358/comments"},"review_comments":{"href":"https://api.github.com/repos/haskell/network/pulls/358/comments"},"review_comment":{"href":"https://api.github.com/repos/haskell/network/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/haskell/network/pulls/358/commits"},"statuses":{"href":"https://api.github.com/repos/haskell/network/statuses/8586f4325e5e080274ebbc1c26090fe54624b3f7"}},"author_association":"COLLABORATOR","merged":false,"mergeable":null,"rebaseable":null,"mergeable_state":"unknown","merged_by":null,"comments":0,"review_comments":0,"maintainer_can_modify":false,"commits":1,"additions":17,"deletions":4,"changed_files":1}}
{"actor":{"display_login":"eborden"}}