{"action":"created","comment":{"url":"https://api.github.com/repos/tc39/proposal-intl-relative-time/pulls/comments/124333370","pull_request_review_id":46612784,"id":124333370,"diff_hunk":"@@ -1,56 +1,160 @@\n-## `Intl.RelativeTimeFormat` API Specification [draft]\n+# `Intl.RelativeTimeFormat` API Specification [draft]\n \n-### Status\n+## Overview\n+\n+### Motivation\n+\n+Due to common use, relative time formatted values exist in a majority of websites and are available in the majority of the frameworks (e.g., React, via [react-intl](https://github.com/yahoo/react-intl) and [react-globalize](https://github.com/globalizejs/react-globalize); Ember, via [ember-intl](https://github.com/ember-intl/ember-intl)). Popular localization libraries like [momentjs](https://momentjs.com/), [formatjs](https://formatjs.io/), [globalizejs](http://globalizejs.com/), and [others](https://github.com/rxaviers/javascript-globalization) had implemented a formatting process for relative time values as well.\n+\n+It is highly probable that the majority of current relative time formatting implementations require a large portion of CLDR raw or compiled data to format relative time values. Bringing this into the platform will improve performance of the web and developer productivity as they no longer have to bring extra weight to format relative time values.\n+\n+### Usage\n+\n+```js\n+// Create a relative time formatter in your locale.\n+let rtf = new Intl.RelativeTimeFormat(\"en\", {\n+    style: \"long\", // \"long\" (default), \"short\", or \"narrow\"\n+});\n+\n+// Format relative time using the day unit.\n+rtf.format(\n+  -1,\n+  \"day\" // \"year\", \"quarter\", \"month\", \"week\", \"day\", \"sun\", \"mon\", \"tue\", \"wed\", \"thu\", \"fri\", \"sat\", \"hour\", \"minute\", or \"second\".\n+);\n+// > \"yesterday\"\n+```\n+\n+### Implementation Status\n \n __Stage 1__\n \n Implementation Progress\n \n- * Polyfill (in progress)\n+- Polyfill (in progress)\n \n Backpointers\n \n- * https://github.com/tc39/ecma402/issues/35\n+- https://github.com/tc39/ecma402/issues/35\n \n-### Authors\n+#### Authors\n \n- * Caridy Patiño (@caridy)\n- * Eric Ferraiuolo (@ericf)\n- * Zibi Braniecki (@zbraniecki)\n+- Caridy Patiño (@caridy)\n+- Eric Ferraiuolo (@ericf)\n+- Zibi Braniecki (@zbraniecki)\n+- Rafael Xavier (@rxaviers)\n+- Daniel Ehrenberg (@littledan) \n \n-### Reviewers\n+#### Reviewers\n \n TBD\n \n-### Informative\n+## Proposal\n+\n+`Intl.RelativeTimeFormat` is a low level API to facilitate libraries and frameworks to format relative time in a localized fashion by providing internationalized messages for date and time fields, using customary word or phrase when available.\n+\n+### Spec\n+\n+You can view the [spec text](spec/relativetimeformat.html) or rendered as [HTML](https://rawgit.com/tc39/intl-relative-time-spec/g/master/index.html).\n+\n+### Technical Design","path":"README.md","position":69,"original_position":69,"commit_id":"d4dc0eb0e442c5cbda081ed0b322e89576313d45","original_commit_id":"d4dc0eb0e442c5cbda081ed0b322e89576313d45","user":{"login":"rxaviers","id":967155,"avatar_url":"https://avatars2.githubusercontent.com/u/967155?v=3","gravatar_id":"","url":"https://api.github.com/users/rxaviers","html_url":"https://github.com/rxaviers","followers_url":"https://api.github.com/users/rxaviers/followers","following_url":"https://api.github.com/users/rxaviers/following{/other_user}","gists_url":"https://api.github.com/users/rxaviers/gists{/gist_id}","starred_url":"https://api.github.com/users/rxaviers/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/rxaviers/subscriptions","organizations_url":"https://api.github.com/users/rxaviers/orgs","repos_url":"https://api.github.com/users/rxaviers/repos","events_url":"https://api.github.com/users/rxaviers/events{/privacy}","received_events_url":"https://api.github.com/users/rxaviers/received_events","type":"User","site_admin":false},"body":"Yeap, good point. Let's include this in a next iteration/PR. I've added an issue to keep track #36.","created_at":"2017-06-27T16:55:04Z","updated_at":"2017-06-27T16:55:04Z","html_url":"https://github.com/tc39/proposal-intl-relative-time/pull/29#discussion_r124333370","pull_request_url":"https://api.github.com/repos/tc39/proposal-intl-relative-time/pulls/29","_links":{"self":{"href":"https://api.github.com/repos/tc39/proposal-intl-relative-time/pulls/comments/124333370"},"html":{"href":"https://github.com/tc39/proposal-intl-relative-time/pull/29#discussion_r124333370"},"pull_request":{"href":"https://api.github.com/repos/tc39/proposal-intl-relative-time/pulls/29"}}},"pull_request":{"url":"https://api.github.com/repos/tc39/proposal-intl-relative-time/pulls/29","id":126997937,"html_url":"https://github.com/tc39/proposal-intl-relative-time/pull/29","diff_url":"https://github.com/tc39/proposal-intl-relative-time/pull/29.diff","patch_url":"https://github.com/tc39/proposal-intl-relative-time/pull/29.patch","issue_url":"https://api.github.com/repos/tc39/proposal-intl-relative-time/issues/29","number":29,"state":"open","locked":false,"title":"Update README, now it includes proposal and design decisions","user":{"login":"rxaviers","id":967155,"avatar_url":"https://avatars2.githubusercontent.com/u/967155?v=3","gravatar_id":"","url":"https://api.github.com/users/rxaviers","html_url":"https://github.com/rxaviers","followers_url":"https://api.github.com/users/rxaviers/followers","following_url":"https://api.github.com/users/rxaviers/following{/other_user}","gists_url":"https://api.github.com/users/rxaviers/gists{/gist_id}","starred_url":"https://api.github.com/users/rxaviers/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/rxaviers/subscriptions","organizations_url":"https://api.github.com/users/rxaviers/orgs","repos_url":"https://api.github.com/users/rxaviers/repos","events_url":"https://api.github.com/users/rxaviers/events{/privacy}","received_events_url":"https://api.github.com/users/rxaviers/received_events","type":"User","site_admin":false},"body":"A big update to the README","created_at":"2017-06-22T13:53:41Z","updated_at":"2017-06-27T16:55:04Z","closed_at":null,"merged_at":null,"merge_commit_sha":"6a29c1e6a4188cabb9739d2b4d867f9154529e53","assignee":null,"assignees":[],"requested_reviewers":[],"milestone":null,"commits_url":"https://api.github.com/repos/tc39/proposal-intl-relative-time/pulls/29/commits","review_comments_url":"https://api.github.com/repos/tc39/proposal-intl-relative-time/pulls/29/comments","review_comment_url":"https://api.github.com/repos/tc39/proposal-intl-relative-time/pulls/comments{/number}","comments_url":"https://api.github.com/repos/tc39/proposal-intl-relative-time/issues/29/comments","statuses_url":"https://api.github.com/repos/tc39/proposal-intl-relative-time/statuses/d4dc0eb0e442c5cbda081ed0b322e89576313d45","head":{"label":"rxaviers:readme-updates","ref":"readme-updates","sha":"d4dc0eb0e442c5cbda081ed0b322e89576313d45","user":{"login":"rxaviers","id":967155,"avatar_url":"https://avatars2.githubusercontent.com/u/967155?v=3","gravatar_id":"","url":"https://api.github.com/users/rxaviers","html_url":"https://github.com/rxaviers","followers_url":"https://api.github.com/users/rxaviers/followers","following_url":"https://api.github.com/users/rxaviers/following{/other_user}","gists_url":"https://api.github.com/users/rxaviers/gists{/gist_id}","starred_url":"https://api.github.com/users/rxaviers/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/rxaviers/subscriptions","organizations_url":"https://api.github.com/users/rxaviers/orgs","repos_url":"https://api.github.com/users/rxaviers/repos","events_url":"https://api.github.com/users/rxaviers/events{/privacy}","received_events_url":"https://api.github.com/users/rxaviers/received_events","type":"User","site_admin":false},"repo":{"id":85614394,"name":"proposal-intl-relative-time","full_name":"rxaviers/proposal-intl-relative-time","owner":{"login":"rxaviers","id":967155,"avatar_url":"https://avatars2.githubusercontent.com/u/967155?v=3","gravatar_id":"","url":"https://api.github.com/users/rxaviers","html_url":"https://github.com/rxaviers","followers_url":"https://api.github.com/users/rxaviers/followers","following_url":"https://api.github.com/users/rxaviers/following{/other_user}","gists_url":"https://api.github.com/users/rxaviers/gists{/gist_id}","starred_url":"https://api.github.com/users/rxaviers/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/rxaviers/subscriptions","organizations_url":"https://api.github.com/users/rxaviers/orgs","repos_url":"https://api.github.com/users/rxaviers/repos","events_url":"https://api.github.com/users/rxaviers/events{/privacy}","received_events_url":"https://api.github.com/users/rxaviers/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/rxaviers/proposal-intl-relative-time","description":"`Intl.RelativeTimeFormat` specification [draft] https://rawgit.com/caridy/intl-relative-time-spec/master/index.html","fork":true,"url":"https://api.github.com/repos/rxaviers/proposal-intl-relative-time","forks_url":"https://api.github.com/repos/rxaviers/proposal-intl-relative-time/forks","keys_url":"https://api.github.com/repos/rxaviers/proposal-intl-relative-time/keys{/key_id}","collaborators_url":"https://api.github.com/repos/rxaviers/proposal-intl-relative-time/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/rxaviers/proposal-intl-relative-time/teams","hooks_url":"https://api.github.com/repos/rxaviers/proposal-intl-relative-time/hooks","issue_events_url":"https://api.github.com/repos/rxaviers/proposal-intl-relative-time/issues/events{/number}","events_url":"https://api.github.com/repos/rxaviers/proposal-intl-relative-time/events","assignees_url":"https://api.github.com/repos/rxaviers/proposal-intl-relative-time/assignees{/user}","branches_url":"https://api.github.com/repos/rxaviers/proposal-intl-relative-time/branches{/branch}","tags_url":"https://api.github.com/repos/rxaviers/proposal-intl-relative-time/tags","blobs_url":"https://api.github.com/repos/rxaviers/proposal-intl-relative-time/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/rxaviers/proposal-intl-relative-time/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/rxaviers/proposal-intl-relative-time/git/refs{/sha}","trees_url":"https://api.github.com/repos/rxaviers/proposal-intl-relative-time/git/trees{/sha}","statuses_url":"https://api.github.com/repos/rxaviers/proposal-intl-relative-time/statuses/{sha}","languages_url":"https://api.github.com/repos/rxaviers/proposal-intl-relative-time/languages","stargazers_url":"https://api.github.com/repos/rxaviers/proposal-intl-relative-time/stargazers","contributors_url":"https://api.github.com/repos/rxaviers/proposal-intl-relative-time/contributors","subscribers_url":"https://api.github.com/repos/rxaviers/proposal-intl-relative-time/subscribers","subscription_url":"https://api.github.com/repos/rxaviers/proposal-intl-relative-time/subscription","commits_url":"https://api.github.com/repos/rxaviers/proposal-intl-relative-time/commits{/sha}","git_commits_url":"https://api.github.com/repos/rxaviers/proposal-intl-relative-time/git/commits{/sha}","comments_url":"https://api.github.com/repos/rxaviers/proposal-intl-relative-time/comments{/number}","issue_comment_url":"https://api.github.com/repos/rxaviers/proposal-intl-relative-time/issues/comments{/number}","contents_url":"https://api.github.com/repos/rxaviers/proposal-intl-relative-time/contents/{+path}","compare_url":"https://api.github.com/repos/rxaviers/proposal-intl-relative-time/compare/{base}...{head}","merges_url":"https://api.github.com/repos/rxaviers/proposal-intl-relative-time/merges","archive_url":"https://api.github.com/repos/rxaviers/proposal-intl-relative-time/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/rxaviers/proposal-intl-relative-time/downloads","issues_url":"https://api.github.com/repos/rxaviers/proposal-intl-relative-time/issues{/number}","pulls_url":"https://api.github.com/repos/rxaviers/proposal-intl-relative-time/pulls{/number}","milestones_url":"https://api.github.com/repos/rxaviers/proposal-intl-relative-time/milestones{/number}","notifications_url":"https://api.github.com/repos/rxaviers/proposal-intl-relative-time/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/rxaviers/proposal-intl-relative-time/labels{/name}","releases_url":"https://api.github.com/repos/rxaviers/proposal-intl-relative-time/releases{/id}","deployments_url":"https://api.github.com/repos/rxaviers/proposal-intl-relative-time/deployments","created_at":"2017-03-20T18:54:27Z","updated_at":"2017-03-20T18:54:28Z","pushed_at":"2017-06-27T16:20:12Z","git_url":"git://github.com/rxaviers/proposal-intl-relative-time.git","ssh_url":"git@github.com:rxaviers/proposal-intl-relative-time.git","clone_url":"https://github.com/rxaviers/proposal-intl-relative-time.git","svn_url":"https://github.com/rxaviers/proposal-intl-relative-time","homepage":"","size":56,"stargazers_count":0,"watchers_count":0,"language":"HTML","has_issues":false,"has_projects":true,"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":"tc39:master","ref":"master","sha":"8d487c58c9ec54923855e84196ae8910f5ecd9a4","user":{"login":"tc39","id":1725583,"avatar_url":"https://avatars1.githubusercontent.com/u/1725583?v=3","gravatar_id":"","url":"https://api.github.com/users/tc39","html_url":"https://github.com/tc39","followers_url":"https://api.github.com/users/tc39/followers","following_url":"https://api.github.com/users/tc39/following{/other_user}","gists_url":"https://api.github.com/users/tc39/gists{/gist_id}","starred_url":"https://api.github.com/users/tc39/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/tc39/subscriptions","organizations_url":"https://api.github.com/users/tc39/orgs","repos_url":"https://api.github.com/users/tc39/repos","events_url":"https://api.github.com/users/tc39/events{/privacy}","received_events_url":"https://api.github.com/users/tc39/received_events","type":"Organization","site_admin":false},"repo":{"id":42794198,"name":"proposal-intl-relative-time","full_name":"tc39/proposal-intl-relative-time","owner":{"login":"tc39","id":1725583,"avatar_url":"https://avatars1.githubusercontent.com/u/1725583?v=3","gravatar_id":"","url":"https://api.github.com/users/tc39","html_url":"https://github.com/tc39","followers_url":"https://api.github.com/users/tc39/followers","following_url":"https://api.github.com/users/tc39/following{/other_user}","gists_url":"https://api.github.com/users/tc39/gists{/gist_id}","starred_url":"https://api.github.com/users/tc39/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/tc39/subscriptions","organizations_url":"https://api.github.com/users/tc39/orgs","repos_url":"https://api.github.com/users/tc39/repos","events_url":"https://api.github.com/users/tc39/events{/privacy}","received_events_url":"https://api.github.com/users/tc39/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/tc39/proposal-intl-relative-time","description":"`Intl.RelativeTimeFormat` specification [draft]","fork":false,"url":"https://api.github.com/repos/tc39/proposal-intl-relative-time","forks_url":"https://api.github.com/repos/tc39/proposal-intl-relative-time/forks","keys_url":"https://api.github.com/repos/tc39/proposal-intl-relative-time/keys{/key_id}","collaborators_url":"https://api.github.com/repos/tc39/proposal-intl-relative-time/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/tc39/proposal-intl-relative-time/teams","hooks_url":"https://api.github.com/repos/tc39/proposal-intl-relative-time/hooks","issue_events_url":"https://api.github.com/repos/tc39/proposal-intl-relative-time/issues/events{/number}","events_url":"https://api.github.com/repos/tc39/proposal-intl-relative-time/events","assignees_url":"https://api.github.com/repos/tc39/proposal-intl-relative-time/assignees{/user}","branches_url":"https://api.github.com/repos/tc39/proposal-intl-relative-time/branches{/branch}","tags_url":"https://api.github.com/repos/tc39/proposal-intl-relative-time/tags","blobs_url":"https://api.github.com/repos/tc39/proposal-intl-relative-time/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/tc39/proposal-intl-relative-time/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/tc39/proposal-intl-relative-time/git/refs{/sha}","trees_url":"https://api.github.com/repos/tc39/proposal-intl-relative-time/git/trees{/sha}","statuses_url":"https://api.github.com/repos/tc39/proposal-intl-relative-time/statuses/{sha}","languages_url":"https://api.github.com/repos/tc39/proposal-intl-relative-time/languages","stargazers_url":"https://api.github.com/repos/tc39/proposal-intl-relative-time/stargazers","contributors_url":"https://api.github.com/repos/tc39/proposal-intl-relative-time/contributors","subscribers_url":"https://api.github.com/repos/tc39/proposal-intl-relative-time/subscribers","subscription_url":"https://api.github.com/repos/tc39/proposal-intl-relative-time/subscription","commits_url":"https://api.github.com/repos/tc39/proposal-intl-relative-time/commits{/sha}","git_commits_url":"https://api.github.com/repos/tc39/proposal-intl-relative-time/git/commits{/sha}","comments_url":"https://api.github.com/repos/tc39/proposal-intl-relative-time/comments{/number}","issue_comment_url":"https://api.github.com/repos/tc39/proposal-intl-relative-time/issues/comments{/number}","contents_url":"https://api.github.com/repos/tc39/proposal-intl-relative-time/contents/{+path}","compare_url":"https://api.github.com/repos/tc39/proposal-intl-relative-time/compare/{base}...{head}","merges_url":"https://api.github.com/repos/tc39/proposal-intl-relative-time/merges","archive_url":"https://api.github.com/repos/tc39/proposal-intl-relative-time/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/tc39/proposal-intl-relative-time/downloads","issues_url":"https://api.github.com/repos/tc39/proposal-intl-relative-time/issues{/number}","pulls_url":"https://api.github.com/repos/tc39/proposal-intl-relative-time/pulls{/number}","milestones_url":"https://api.github.com/repos/tc39/proposal-intl-relative-time/milestones{/number}","notifications_url":"https://api.github.com/repos/tc39/proposal-intl-relative-time/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/tc39/proposal-intl-relative-time/labels{/name}","releases_url":"https://api.github.com/repos/tc39/proposal-intl-relative-time/releases{/id}","deployments_url":"https://api.github.com/repos/tc39/proposal-intl-relative-time/deployments","created_at":"2015-09-20T00:08:02Z","updated_at":"2017-06-27T16:17:59Z","pushed_at":"2017-06-27T16:20:13Z","git_url":"git://github.com/tc39/proposal-intl-relative-time.git","ssh_url":"git@github.com:tc39/proposal-intl-relative-time.git","clone_url":"https://github.com/tc39/proposal-intl-relative-time.git","svn_url":"https://github.com/tc39/proposal-intl-relative-time","homepage":"https://rawgit.com/tc39/intl-relative-time-spec/master/index.html","size":52,"stargazers_count":0,"watchers_count":0,"language":"HTML","has_issues":true,"has_projects":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":3,"mirror_url":null,"open_issues_count":11,"forks":3,"open_issues":11,"watchers":0,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/tc39/proposal-intl-relative-time/pulls/29"},"html":{"href":"https://github.com/tc39/proposal-intl-relative-time/pull/29"},"issue":{"href":"https://api.github.com/repos/tc39/proposal-intl-relative-time/issues/29"},"comments":{"href":"https://api.github.com/repos/tc39/proposal-intl-relative-time/issues/29/comments"},"review_comments":{"href":"https://api.github.com/repos/tc39/proposal-intl-relative-time/pulls/29/comments"},"review_comment":{"href":"https://api.github.com/repos/tc39/proposal-intl-relative-time/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/tc39/proposal-intl-relative-time/pulls/29/commits"},"statuses":{"href":"https://api.github.com/repos/tc39/proposal-intl-relative-time/statuses/d4dc0eb0e442c5cbda081ed0b322e89576313d45"}}}}
{"actor":{"display_login":"rxaviers"}}