{"action":"created","comment":{"url":"https://api.github.com/repos/rejectedsoftware/vibe.d/pulls/comments/34433825","id":34433825,"diff_hunk":"@@ -1,12 +1,228 @@\n /**\n-\tAutomatic REST interface and client code generation facilities.\n-\n-\tCopyright: © 2012-2013 RejectedSoftware e.K.\n-\tLicense: Subject to the terms of the MIT license, as written in the included LICENSE.txt file.\n-\tAuthors: Sönke Ludwig, Михаил Страшун\n-*/\n+ * Module to work with REST API, from both server and client side.\n+ *\n+ * This modules aims to provide a typesafe way to deal with REST API.\n+ * As they are quite a lot of similarities between them, this module use\n+ * D interfaces as the way to represent REST API.\n+ * While REST is not HTTP specific, the vast majority of use cases rely on it,\n+ * and so does this module.\n+ *\n+ * This module, while being usable and more convenient from both client and\n+ * server side, is also usable solely for its client or server implementation.\n+ * The following documentation will explain in details how this module work,\n+ * without any specifics about the client or server side.\n+ * Since each implementation only require the use of one symbol from here,\n+ * specifics are explained on those. You can thus find server only\n+ * documentation on $(D registerRestInterface) and client only documentation\n+ * on $(D RestInterfaceClient).\n+ *\n+ * There are few advantages in using this module over the more basic `vibe.http`\n+ * package provided:","path":"source/vibe/web/rest.d","position":26,"original_position":26,"commit_id":"ea061223ab96d5acdc004e9369f904c5e25ec8d0","original_commit_id":"ea061223ab96d5acdc004e9369f904c5e25ec8d0","user":{"login":"Dicebot","id":1132234,"avatar_url":"https://avatars.githubusercontent.com/u/1132234?v=3","gravatar_id":"","url":"https://api.github.com/users/Dicebot","html_url":"https://github.com/Dicebot","followers_url":"https://api.github.com/users/Dicebot/followers","following_url":"https://api.github.com/users/Dicebot/following{/other_user}","gists_url":"https://api.github.com/users/Dicebot/gists{/gist_id}","starred_url":"https://api.github.com/users/Dicebot/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/Dicebot/subscriptions","organizations_url":"https://api.github.com/users/Dicebot/orgs","repos_url":"https://api.github.com/users/Dicebot/repos","events_url":"https://api.github.com/users/Dicebot/events{/privacy}","received_events_url":"https://api.github.com/users/Dicebot/received_events","type":"User","site_admin":false},"body":"Probably worth mentioning that one in `vibe.http` is the legacy version that is going to be eventually deprecated (I presume so?)","created_at":"2015-07-13T05:11:32Z","updated_at":"2015-07-13T05:11:32Z","html_url":"https://github.com/rejectedsoftware/vibe.d/pull/1145#discussion_r34433825","pull_request_url":"https://api.github.com/repos/rejectedsoftware/vibe.d/pulls/1145","_links":{"self":{"href":"https://api.github.com/repos/rejectedsoftware/vibe.d/pulls/comments/34433825"},"html":{"href":"https://github.com/rejectedsoftware/vibe.d/pull/1145#discussion_r34433825"},"pull_request":{"href":"https://api.github.com/repos/rejectedsoftware/vibe.d/pulls/1145"}}},"pull_request":{"url":"https://api.github.com/repos/rejectedsoftware/vibe.d/pulls/1145","id":37956271,"html_url":"https://github.com/rejectedsoftware/vibe.d/pull/1145","diff_url":"https://github.com/rejectedsoftware/vibe.d/pull/1145.diff","patch_url":"https://github.com/rejectedsoftware/vibe.d/pull/1145.patch","issue_url":"https://api.github.com/repos/rejectedsoftware/vibe.d/issues/1145","number":1145,"state":"open","locked":false,"title":"[DRAFT][REST] Document vibe.web.rest better","user":{"login":"Geod24","id":2180215,"avatar_url":"https://avatars.githubusercontent.com/u/2180215?v=3","gravatar_id":"","url":"https://api.github.com/users/Geod24","html_url":"https://github.com/Geod24","followers_url":"https://api.github.com/users/Geod24/followers","following_url":"https://api.github.com/users/Geod24/following{/other_user}","gists_url":"https://api.github.com/users/Geod24/gists{/gist_id}","starred_url":"https://api.github.com/users/Geod24/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/Geod24/subscriptions","organizations_url":"https://api.github.com/users/Geod24/orgs","repos_url":"https://api.github.com/users/Geod24/repos","events_url":"https://api.github.com/users/Geod24/events{/privacy}","received_events_url":"https://api.github.com/users/Geod24/received_events","type":"User","site_admin":false},"body":"This aims to extend the documentation of Vibe.web.rest into something that's exhaustive.\r\nIn it's present state, it is **not** ready to be pulled, because it hasn't been thoroughly proof-read, the server part is not complete, and I hadn't started on the client part.\r\n\r\nHowever, I'm quite happy with the coverage of the module documentation. I intend it for general (as in both client and server) behaviour, while the individual client / server are for their specific behaviour (e.g. exception behaviour for the server, optimization via `final` which is not there yet, etc...).\r\n\r\nSo if you would like to review the module part / discuss the features, feel free (guess you can put a 'discussion' tag directly ;) ).","created_at":"2015-06-17T22:59:05Z","updated_at":"2015-07-13T05:11:32Z","closed_at":null,"merged_at":null,"merge_commit_sha":"7d2f4f5efcb54dbc78d967a9e48b06e862075433","assignee":null,"milestone":null,"commits_url":"https://api.github.com/repos/rejectedsoftware/vibe.d/pulls/1145/commits","review_comments_url":"https://api.github.com/repos/rejectedsoftware/vibe.d/pulls/1145/comments","review_comment_url":"https://api.github.com/repos/rejectedsoftware/vibe.d/pulls/comments{/number}","comments_url":"https://api.github.com/repos/rejectedsoftware/vibe.d/issues/1145/comments","statuses_url":"https://api.github.com/repos/rejectedsoftware/vibe.d/statuses/ea061223ab96d5acdc004e9369f904c5e25ec8d0","head":{"label":"Geod24:documentation","ref":"documentation","sha":"ea061223ab96d5acdc004e9369f904c5e25ec8d0","user":{"login":"Geod24","id":2180215,"avatar_url":"https://avatars.githubusercontent.com/u/2180215?v=3","gravatar_id":"","url":"https://api.github.com/users/Geod24","html_url":"https://github.com/Geod24","followers_url":"https://api.github.com/users/Geod24/followers","following_url":"https://api.github.com/users/Geod24/following{/other_user}","gists_url":"https://api.github.com/users/Geod24/gists{/gist_id}","starred_url":"https://api.github.com/users/Geod24/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/Geod24/subscriptions","organizations_url":"https://api.github.com/users/Geod24/orgs","repos_url":"https://api.github.com/users/Geod24/repos","events_url":"https://api.github.com/users/Geod24/events{/privacy}","received_events_url":"https://api.github.com/users/Geod24/received_events","type":"User","site_admin":false},"repo":{"id":14656841,"name":"vibe.d","full_name":"Geod24/vibe.d","owner":{"login":"Geod24","id":2180215,"avatar_url":"https://avatars.githubusercontent.com/u/2180215?v=3","gravatar_id":"","url":"https://api.github.com/users/Geod24","html_url":"https://github.com/Geod24","followers_url":"https://api.github.com/users/Geod24/followers","following_url":"https://api.github.com/users/Geod24/following{/other_user}","gists_url":"https://api.github.com/users/Geod24/gists{/gist_id}","starred_url":"https://api.github.com/users/Geod24/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/Geod24/subscriptions","organizations_url":"https://api.github.com/users/Geod24/orgs","repos_url":"https://api.github.com/users/Geod24/repos","events_url":"https://api.github.com/users/Geod24/events{/privacy}","received_events_url":"https://api.github.com/users/Geod24/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/Geod24/vibe.d","description":"Official vibe.d development","fork":true,"url":"https://api.github.com/repos/Geod24/vibe.d","forks_url":"https://api.github.com/repos/Geod24/vibe.d/forks","keys_url":"https://api.github.com/repos/Geod24/vibe.d/keys{/key_id}","collaborators_url":"https://api.github.com/repos/Geod24/vibe.d/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/Geod24/vibe.d/teams","hooks_url":"https://api.github.com/repos/Geod24/vibe.d/hooks","issue_events_url":"https://api.github.com/repos/Geod24/vibe.d/issues/events{/number}","events_url":"https://api.github.com/repos/Geod24/vibe.d/events","assignees_url":"https://api.github.com/repos/Geod24/vibe.d/assignees{/user}","branches_url":"https://api.github.com/repos/Geod24/vibe.d/branches{/branch}","tags_url":"https://api.github.com/repos/Geod24/vibe.d/tags","blobs_url":"https://api.github.com/repos/Geod24/vibe.d/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/Geod24/vibe.d/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/Geod24/vibe.d/git/refs{/sha}","trees_url":"https://api.github.com/repos/Geod24/vibe.d/git/trees{/sha}","statuses_url":"https://api.github.com/repos/Geod24/vibe.d/statuses/{sha}","languages_url":"https://api.github.com/repos/Geod24/vibe.d/languages","stargazers_url":"https://api.github.com/repos/Geod24/vibe.d/stargazers","contributors_url":"https://api.github.com/repos/Geod24/vibe.d/contributors","subscribers_url":"https://api.github.com/repos/Geod24/vibe.d/subscribers","subscription_url":"https://api.github.com/repos/Geod24/vibe.d/subscription","commits_url":"https://api.github.com/repos/Geod24/vibe.d/commits{/sha}","git_commits_url":"https://api.github.com/repos/Geod24/vibe.d/git/commits{/sha}","comments_url":"https://api.github.com/repos/Geod24/vibe.d/comments{/number}","issue_comment_url":"https://api.github.com/repos/Geod24/vibe.d/issues/comments{/number}","contents_url":"https://api.github.com/repos/Geod24/vibe.d/contents/{+path}","compare_url":"https://api.github.com/repos/Geod24/vibe.d/compare/{base}...{head}","merges_url":"https://api.github.com/repos/Geod24/vibe.d/merges","archive_url":"https://api.github.com/repos/Geod24/vibe.d/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/Geod24/vibe.d/downloads","issues_url":"https://api.github.com/repos/Geod24/vibe.d/issues{/number}","pulls_url":"https://api.github.com/repos/Geod24/vibe.d/pulls{/number}","milestones_url":"https://api.github.com/repos/Geod24/vibe.d/milestones{/number}","notifications_url":"https://api.github.com/repos/Geod24/vibe.d/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/Geod24/vibe.d/labels{/name}","releases_url":"https://api.github.com/repos/Geod24/vibe.d/releases{/id}","created_at":"2013-11-24T06:25:55Z","updated_at":"2015-05-04T06:40:00Z","pushed_at":"2015-07-13T03:37:53Z","git_url":"git://github.com/Geod24/vibe.d.git","ssh_url":"git@github.com:Geod24/vibe.d.git","clone_url":"https://github.com/Geod24/vibe.d.git","svn_url":"https://github.com/Geod24/vibe.d","homepage":null,"size":16882,"stargazers_count":0,"watchers_count":0,"language":"D","has_issues":false,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":0,"mirror_url":null,"open_issues_count":0,"forks":0,"open_issues":0,"watchers":0,"default_branch":"master"}},"base":{"label":"rejectedsoftware:master","ref":"master","sha":"eca2ebcf7df0e082c5b68344d057a4c8bc0ea927","user":{"login":"rejectedsoftware","id":1661098,"avatar_url":"https://avatars.githubusercontent.com/u/1661098?v=3","gravatar_id":"","url":"https://api.github.com/users/rejectedsoftware","html_url":"https://github.com/rejectedsoftware","followers_url":"https://api.github.com/users/rejectedsoftware/followers","following_url":"https://api.github.com/users/rejectedsoftware/following{/other_user}","gists_url":"https://api.github.com/users/rejectedsoftware/gists{/gist_id}","starred_url":"https://api.github.com/users/rejectedsoftware/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/rejectedsoftware/subscriptions","organizations_url":"https://api.github.com/users/rejectedsoftware/orgs","repos_url":"https://api.github.com/users/rejectedsoftware/repos","events_url":"https://api.github.com/users/rejectedsoftware/events{/privacy}","received_events_url":"https://api.github.com/users/rejectedsoftware/received_events","type":"Organization","site_admin":false},"repo":{"id":4081150,"name":"vibe.d","full_name":"rejectedsoftware/vibe.d","owner":{"login":"rejectedsoftware","id":1661098,"avatar_url":"https://avatars.githubusercontent.com/u/1661098?v=3","gravatar_id":"","url":"https://api.github.com/users/rejectedsoftware","html_url":"https://github.com/rejectedsoftware","followers_url":"https://api.github.com/users/rejectedsoftware/followers","following_url":"https://api.github.com/users/rejectedsoftware/following{/other_user}","gists_url":"https://api.github.com/users/rejectedsoftware/gists{/gist_id}","starred_url":"https://api.github.com/users/rejectedsoftware/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/rejectedsoftware/subscriptions","organizations_url":"https://api.github.com/users/rejectedsoftware/orgs","repos_url":"https://api.github.com/users/rejectedsoftware/repos","events_url":"https://api.github.com/users/rejectedsoftware/events{/privacy}","received_events_url":"https://api.github.com/users/rejectedsoftware/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/rejectedsoftware/vibe.d","description":"Official vibe.d development","fork":false,"url":"https://api.github.com/repos/rejectedsoftware/vibe.d","forks_url":"https://api.github.com/repos/rejectedsoftware/vibe.d/forks","keys_url":"https://api.github.com/repos/rejectedsoftware/vibe.d/keys{/key_id}","collaborators_url":"https://api.github.com/repos/rejectedsoftware/vibe.d/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/rejectedsoftware/vibe.d/teams","hooks_url":"https://api.github.com/repos/rejectedsoftware/vibe.d/hooks","issue_events_url":"https://api.github.com/repos/rejectedsoftware/vibe.d/issues/events{/number}","events_url":"https://api.github.com/repos/rejectedsoftware/vibe.d/events","assignees_url":"https://api.github.com/repos/rejectedsoftware/vibe.d/assignees{/user}","branches_url":"https://api.github.com/repos/rejectedsoftware/vibe.d/branches{/branch}","tags_url":"https://api.github.com/repos/rejectedsoftware/vibe.d/tags","blobs_url":"https://api.github.com/repos/rejectedsoftware/vibe.d/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/rejectedsoftware/vibe.d/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/rejectedsoftware/vibe.d/git/refs{/sha}","trees_url":"https://api.github.com/repos/rejectedsoftware/vibe.d/git/trees{/sha}","statuses_url":"https://api.github.com/repos/rejectedsoftware/vibe.d/statuses/{sha}","languages_url":"https://api.github.com/repos/rejectedsoftware/vibe.d/languages","stargazers_url":"https://api.github.com/repos/rejectedsoftware/vibe.d/stargazers","contributors_url":"https://api.github.com/repos/rejectedsoftware/vibe.d/contributors","subscribers_url":"https://api.github.com/repos/rejectedsoftware/vibe.d/subscribers","subscription_url":"https://api.github.com/repos/rejectedsoftware/vibe.d/subscription","commits_url":"https://api.github.com/repos/rejectedsoftware/vibe.d/commits{/sha}","git_commits_url":"https://api.github.com/repos/rejectedsoftware/vibe.d/git/commits{/sha}","comments_url":"https://api.github.com/repos/rejectedsoftware/vibe.d/comments{/number}","issue_comment_url":"https://api.github.com/repos/rejectedsoftware/vibe.d/issues/comments{/number}","contents_url":"https://api.github.com/repos/rejectedsoftware/vibe.d/contents/{+path}","compare_url":"https://api.github.com/repos/rejectedsoftware/vibe.d/compare/{base}...{head}","merges_url":"https://api.github.com/repos/rejectedsoftware/vibe.d/merges","archive_url":"https://api.github.com/repos/rejectedsoftware/vibe.d/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/rejectedsoftware/vibe.d/downloads","issues_url":"https://api.github.com/repos/rejectedsoftware/vibe.d/issues{/number}","pulls_url":"https://api.github.com/repos/rejectedsoftware/vibe.d/pulls{/number}","milestones_url":"https://api.github.com/repos/rejectedsoftware/vibe.d/milestones{/number}","notifications_url":"https://api.github.com/repos/rejectedsoftware/vibe.d/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/rejectedsoftware/vibe.d/labels{/name}","releases_url":"https://api.github.com/repos/rejectedsoftware/vibe.d/releases{/id}","created_at":"2012-04-19T23:10:11Z","updated_at":"2015-07-12T00:12:33Z","pushed_at":"2015-07-12T16:03:23Z","git_url":"git://github.com/rejectedsoftware/vibe.d.git","ssh_url":"git@github.com:rejectedsoftware/vibe.d.git","clone_url":"https://github.com/rejectedsoftware/vibe.d.git","svn_url":"https://github.com/rejectedsoftware/vibe.d","homepage":null,"size":25530,"stargazers_count":632,"watchers_count":632,"language":"D","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":190,"mirror_url":null,"open_issues_count":226,"forks":190,"open_issues":226,"watchers":632,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/rejectedsoftware/vibe.d/pulls/1145"},"html":{"href":"https://github.com/rejectedsoftware/vibe.d/pull/1145"},"issue":{"href":"https://api.github.com/repos/rejectedsoftware/vibe.d/issues/1145"},"comments":{"href":"https://api.github.com/repos/rejectedsoftware/vibe.d/issues/1145/comments"},"review_comments":{"href":"https://api.github.com/repos/rejectedsoftware/vibe.d/pulls/1145/comments"},"review_comment":{"href":"https://api.github.com/repos/rejectedsoftware/vibe.d/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/rejectedsoftware/vibe.d/pulls/1145/commits"},"statuses":{"href":"https://api.github.com/repos/rejectedsoftware/vibe.d/statuses/ea061223ab96d5acdc004e9369f904c5e25ec8d0"}}}}