{"action":"created","comment":{"url":"https://api.github.com/repos/w3c/sensors/pulls/comments/141426884","pull_request_review_id":65639106,"id":141426884,"diff_hunk":"@@ -644,6 +639,31 @@ The [=reading change threshold|threshold=] value depends on the surrounding soft\n environment constraints, e.g., software power consumption optimizations or the underlying\n [=device sensor=]'s accuracy.\n \n+## Sampling Frequency and Reporting Frequency ## {#concepts-sampling-and-reporting-frequencies}\n+\n+For the purpose of this specification, <dfn>sampling frequency</dfn> for a [=platform sensor=] is\n+defined as a frequency at which the user agent obtains [=sensor readings=] from the underlying\n+platform.\n+\n+The user agent can request the underlying platform to deliver [=sensor readings|readings=] at a certain\n+rate which is called <dfn>requested sampling frequency</dfn>.\n+\n+The [=sampling frequency=] is equal to the [=requested sampling frequency=] if the underlying platform\n+can support it.\n+\n+The [=sampling frequency=] differs from the [=requested sampling frequency=] in the following cases:\n+ - the [=requested sampling frequency=] exceeds upper or lower [=sampling frequency=] bounds\n+   supported by the underlying platform.\n+ - the [=reading change threshold|threshold=] value is significant so that some of the\n+   [=device sensor=]' measurements are skipped and the [=sensor readings=] are not updated.","path":"index.bs","position":32,"original_position":32,"commit_id":"64067af959e98c2a5d363c87d54fe7279b9b56c7","original_commit_id":"64067af959e98c2a5d363c87d54fe7279b9b56c7","user":{"login":"rwaldron","id":27985,"avatar_url":"https://avatars3.githubusercontent.com/u/27985?v=4","gravatar_id":"","url":"https://api.github.com/users/rwaldron","html_url":"https://github.com/rwaldron","followers_url":"https://api.github.com/users/rwaldron/followers","following_url":"https://api.github.com/users/rwaldron/following{/other_user}","gists_url":"https://api.github.com/users/rwaldron/gists{/gist_id}","starred_url":"https://api.github.com/users/rwaldron/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/rwaldron/subscriptions","organizations_url":"https://api.github.com/users/rwaldron/orgs","repos_url":"https://api.github.com/users/rwaldron/repos","events_url":"https://api.github.com/users/rwaldron/events{/privacy}","received_events_url":"https://api.github.com/users/rwaldron/received_events","type":"User","site_admin":false},"body":"`[=device sensor=]' measurements` => `[=device sensor=]'s measurements`","created_at":"2017-09-27T18:19:25Z","updated_at":"2017-09-27T18:23:37Z","html_url":"https://github.com/w3c/sensors/pull/290#discussion_r141426884","pull_request_url":"https://api.github.com/repos/w3c/sensors/pulls/290","author_association":"COLLABORATOR","_links":{"self":{"href":"https://api.github.com/repos/w3c/sensors/pulls/comments/141426884"},"html":{"href":"https://github.com/w3c/sensors/pull/290#discussion_r141426884"},"pull_request":{"href":"https://api.github.com/repos/w3c/sensors/pulls/290"}}},"pull_request":{"url":"https://api.github.com/repos/w3c/sensors/pulls/290","id":143374374,"html_url":"https://github.com/w3c/sensors/pull/290","diff_url":"https://github.com/w3c/sensors/pull/290.diff","patch_url":"https://github.com/w3c/sensors/pull/290.patch","issue_url":"https://api.github.com/repos/w3c/sensors/issues/290","number":290,"state":"open","locked":false,"title":"Clarify sensor frequency concepts","user":{"login":"pozdnyakov","id":998253,"avatar_url":"https://avatars1.githubusercontent.com/u/998253?v=4","gravatar_id":"","url":"https://api.github.com/users/pozdnyakov","html_url":"https://github.com/pozdnyakov","followers_url":"https://api.github.com/users/pozdnyakov/followers","following_url":"https://api.github.com/users/pozdnyakov/following{/other_user}","gists_url":"https://api.github.com/users/pozdnyakov/gists{/gist_id}","starred_url":"https://api.github.com/users/pozdnyakov/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/pozdnyakov/subscriptions","organizations_url":"https://api.github.com/users/pozdnyakov/orgs","repos_url":"https://api.github.com/users/pozdnyakov/repos","events_url":"https://api.github.com/users/pozdnyakov/events{/privacy}","received_events_url":"https://api.github.com/users/pozdnyakov/received_events","type":"User","site_admin":false},"body":"Make a split between 'sampling frequency' which is set for a platform\nsensor and 'reporting frequency' which is set for a Sensor object.\n\n\n<!--\n    This comment and the below content is programatically generated.\n    You may add a comma-separated list of anchors you'd like a\n    direct link to below (e.g. #idl-serializers, #idl-sequence):\n\n    Don't remove this comment or modify anything below this line.\n    If you don't want a preview generated for this pull request,\n    just replace the whole of this comment's content by \"no preview\"\n    and remove what's below.\n-->\n***\n[Preview](https://s3.amazonaws.com/pr-preview/pozdnyakov/sensors/reportingFrequency.html) | [Diff](https://s3.amazonaws.com/pr-preview/w3c/sensors/bfff399...pozdnyakov:64067af.html)","created_at":"2017-09-27T12:08:16Z","updated_at":"2017-09-27T18:23:37Z","closed_at":null,"merged_at":null,"merge_commit_sha":"f5cf01394a6c40457206ead283c1436872a1b5f8","assignee":null,"assignees":[],"requested_reviewers":[],"milestone":null,"commits_url":"https://api.github.com/repos/w3c/sensors/pulls/290/commits","review_comments_url":"https://api.github.com/repos/w3c/sensors/pulls/290/comments","review_comment_url":"https://api.github.com/repos/w3c/sensors/pulls/comments{/number}","comments_url":"https://api.github.com/repos/w3c/sensors/issues/290/comments","statuses_url":"https://api.github.com/repos/w3c/sensors/statuses/64067af959e98c2a5d363c87d54fe7279b9b56c7","head":{"label":"pozdnyakov:reportingFrequency","ref":"reportingFrequency","sha":"64067af959e98c2a5d363c87d54fe7279b9b56c7","user":{"login":"pozdnyakov","id":998253,"avatar_url":"https://avatars1.githubusercontent.com/u/998253?v=4","gravatar_id":"","url":"https://api.github.com/users/pozdnyakov","html_url":"https://github.com/pozdnyakov","followers_url":"https://api.github.com/users/pozdnyakov/followers","following_url":"https://api.github.com/users/pozdnyakov/following{/other_user}","gists_url":"https://api.github.com/users/pozdnyakov/gists{/gist_id}","starred_url":"https://api.github.com/users/pozdnyakov/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/pozdnyakov/subscriptions","organizations_url":"https://api.github.com/users/pozdnyakov/orgs","repos_url":"https://api.github.com/users/pozdnyakov/repos","events_url":"https://api.github.com/users/pozdnyakov/events{/privacy}","received_events_url":"https://api.github.com/users/pozdnyakov/received_events","type":"User","site_admin":false},"repo":{"id":84816666,"name":"sensors","full_name":"pozdnyakov/sensors","owner":{"login":"pozdnyakov","id":998253,"avatar_url":"https://avatars1.githubusercontent.com/u/998253?v=4","gravatar_id":"","url":"https://api.github.com/users/pozdnyakov","html_url":"https://github.com/pozdnyakov","followers_url":"https://api.github.com/users/pozdnyakov/followers","following_url":"https://api.github.com/users/pozdnyakov/following{/other_user}","gists_url":"https://api.github.com/users/pozdnyakov/gists{/gist_id}","starred_url":"https://api.github.com/users/pozdnyakov/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/pozdnyakov/subscriptions","organizations_url":"https://api.github.com/users/pozdnyakov/orgs","repos_url":"https://api.github.com/users/pozdnyakov/repos","events_url":"https://api.github.com/users/pozdnyakov/events{/privacy}","received_events_url":"https://api.github.com/users/pozdnyakov/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/pozdnyakov/sensors","description":"Generic Sensor API","fork":true,"url":"https://api.github.com/repos/pozdnyakov/sensors","forks_url":"https://api.github.com/repos/pozdnyakov/sensors/forks","keys_url":"https://api.github.com/repos/pozdnyakov/sensors/keys{/key_id}","collaborators_url":"https://api.github.com/repos/pozdnyakov/sensors/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/pozdnyakov/sensors/teams","hooks_url":"https://api.github.com/repos/pozdnyakov/sensors/hooks","issue_events_url":"https://api.github.com/repos/pozdnyakov/sensors/issues/events{/number}","events_url":"https://api.github.com/repos/pozdnyakov/sensors/events","assignees_url":"https://api.github.com/repos/pozdnyakov/sensors/assignees{/user}","branches_url":"https://api.github.com/repos/pozdnyakov/sensors/branches{/branch}","tags_url":"https://api.github.com/repos/pozdnyakov/sensors/tags","blobs_url":"https://api.github.com/repos/pozdnyakov/sensors/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/pozdnyakov/sensors/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/pozdnyakov/sensors/git/refs{/sha}","trees_url":"https://api.github.com/repos/pozdnyakov/sensors/git/trees{/sha}","statuses_url":"https://api.github.com/repos/pozdnyakov/sensors/statuses/{sha}","languages_url":"https://api.github.com/repos/pozdnyakov/sensors/languages","stargazers_url":"https://api.github.com/repos/pozdnyakov/sensors/stargazers","contributors_url":"https://api.github.com/repos/pozdnyakov/sensors/contributors","subscribers_url":"https://api.github.com/repos/pozdnyakov/sensors/subscribers","subscription_url":"https://api.github.com/repos/pozdnyakov/sensors/subscription","commits_url":"https://api.github.com/repos/pozdnyakov/sensors/commits{/sha}","git_commits_url":"https://api.github.com/repos/pozdnyakov/sensors/git/commits{/sha}","comments_url":"https://api.github.com/repos/pozdnyakov/sensors/comments{/number}","issue_comment_url":"https://api.github.com/repos/pozdnyakov/sensors/issues/comments{/number}","contents_url":"https://api.github.com/repos/pozdnyakov/sensors/contents/{+path}","compare_url":"https://api.github.com/repos/pozdnyakov/sensors/compare/{base}...{head}","merges_url":"https://api.github.com/repos/pozdnyakov/sensors/merges","archive_url":"https://api.github.com/repos/pozdnyakov/sensors/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/pozdnyakov/sensors/downloads","issues_url":"https://api.github.com/repos/pozdnyakov/sensors/issues{/number}","pulls_url":"https://api.github.com/repos/pozdnyakov/sensors/pulls{/number}","milestones_url":"https://api.github.com/repos/pozdnyakov/sensors/milestones{/number}","notifications_url":"https://api.github.com/repos/pozdnyakov/sensors/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/pozdnyakov/sensors/labels{/name}","releases_url":"https://api.github.com/repos/pozdnyakov/sensors/releases{/id}","deployments_url":"https://api.github.com/repos/pozdnyakov/sensors/deployments","created_at":"2017-03-13T11:02:44Z","updated_at":"2017-03-13T11:02:46Z","pushed_at":"2017-09-27T12:07:31Z","git_url":"git://github.com/pozdnyakov/sensors.git","ssh_url":"git@github.com:pozdnyakov/sensors.git","clone_url":"https://github.com/pozdnyakov/sensors.git","svn_url":"https://github.com/pozdnyakov/sensors","homepage":"https://w3c.github.io/sensors/","size":1467,"stargazers_count":0,"watchers_count":0,"language":"HTML","has_issues":false,"has_projects":true,"has_downloads":true,"has_wiki":false,"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":"w3c:master","ref":"master","sha":"bfff3991c051a35a3e935b0e3adb8d58bef4aea9","user":{"login":"w3c","id":379216,"avatar_url":"https://avatars2.githubusercontent.com/u/379216?v=4","gravatar_id":"","url":"https://api.github.com/users/w3c","html_url":"https://github.com/w3c","followers_url":"https://api.github.com/users/w3c/followers","following_url":"https://api.github.com/users/w3c/following{/other_user}","gists_url":"https://api.github.com/users/w3c/gists{/gist_id}","starred_url":"https://api.github.com/users/w3c/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/w3c/subscriptions","organizations_url":"https://api.github.com/users/w3c/orgs","repos_url":"https://api.github.com/users/w3c/repos","events_url":"https://api.github.com/users/w3c/events{/privacy}","received_events_url":"https://api.github.com/users/w3c/received_events","type":"Organization","site_admin":false},"repo":{"id":26634225,"name":"sensors","full_name":"w3c/sensors","owner":{"login":"w3c","id":379216,"avatar_url":"https://avatars2.githubusercontent.com/u/379216?v=4","gravatar_id":"","url":"https://api.github.com/users/w3c","html_url":"https://github.com/w3c","followers_url":"https://api.github.com/users/w3c/followers","following_url":"https://api.github.com/users/w3c/following{/other_user}","gists_url":"https://api.github.com/users/w3c/gists{/gist_id}","starred_url":"https://api.github.com/users/w3c/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/w3c/subscriptions","organizations_url":"https://api.github.com/users/w3c/orgs","repos_url":"https://api.github.com/users/w3c/repos","events_url":"https://api.github.com/users/w3c/events{/privacy}","received_events_url":"https://api.github.com/users/w3c/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/w3c/sensors","description":"Generic Sensor API","fork":false,"url":"https://api.github.com/repos/w3c/sensors","forks_url":"https://api.github.com/repos/w3c/sensors/forks","keys_url":"https://api.github.com/repos/w3c/sensors/keys{/key_id}","collaborators_url":"https://api.github.com/repos/w3c/sensors/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/w3c/sensors/teams","hooks_url":"https://api.github.com/repos/w3c/sensors/hooks","issue_events_url":"https://api.github.com/repos/w3c/sensors/issues/events{/number}","events_url":"https://api.github.com/repos/w3c/sensors/events","assignees_url":"https://api.github.com/repos/w3c/sensors/assignees{/user}","branches_url":"https://api.github.com/repos/w3c/sensors/branches{/branch}","tags_url":"https://api.github.com/repos/w3c/sensors/tags","blobs_url":"https://api.github.com/repos/w3c/sensors/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/w3c/sensors/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/w3c/sensors/git/refs{/sha}","trees_url":"https://api.github.com/repos/w3c/sensors/git/trees{/sha}","statuses_url":"https://api.github.com/repos/w3c/sensors/statuses/{sha}","languages_url":"https://api.github.com/repos/w3c/sensors/languages","stargazers_url":"https://api.github.com/repos/w3c/sensors/stargazers","contributors_url":"https://api.github.com/repos/w3c/sensors/contributors","subscribers_url":"https://api.github.com/repos/w3c/sensors/subscribers","subscription_url":"https://api.github.com/repos/w3c/sensors/subscription","commits_url":"https://api.github.com/repos/w3c/sensors/commits{/sha}","git_commits_url":"https://api.github.com/repos/w3c/sensors/git/commits{/sha}","comments_url":"https://api.github.com/repos/w3c/sensors/comments{/number}","issue_comment_url":"https://api.github.com/repos/w3c/sensors/issues/comments{/number}","contents_url":"https://api.github.com/repos/w3c/sensors/contents/{+path}","compare_url":"https://api.github.com/repos/w3c/sensors/compare/{base}...{head}","merges_url":"https://api.github.com/repos/w3c/sensors/merges","archive_url":"https://api.github.com/repos/w3c/sensors/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/w3c/sensors/downloads","issues_url":"https://api.github.com/repos/w3c/sensors/issues{/number}","pulls_url":"https://api.github.com/repos/w3c/sensors/pulls{/number}","milestones_url":"https://api.github.com/repos/w3c/sensors/milestones{/number}","notifications_url":"https://api.github.com/repos/w3c/sensors/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/w3c/sensors/labels{/name}","releases_url":"https://api.github.com/repos/w3c/sensors/releases{/id}","deployments_url":"https://api.github.com/repos/w3c/sensors/deployments","created_at":"2014-11-14T10:42:31Z","updated_at":"2017-09-12T15:41:38Z","pushed_at":"2017-09-27T17:51:26Z","git_url":"git://github.com/w3c/sensors.git","ssh_url":"git@github.com:w3c/sensors.git","clone_url":"https://github.com/w3c/sensors.git","svn_url":"https://github.com/w3c/sensors","homepage":"https://w3c.github.io/sensors/","size":1500,"stargazers_count":90,"watchers_count":90,"language":"HTML","has_issues":true,"has_projects":true,"has_downloads":true,"has_wiki":false,"has_pages":true,"forks_count":34,"mirror_url":null,"open_issues_count":39,"forks":34,"open_issues":39,"watchers":90,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/w3c/sensors/pulls/290"},"html":{"href":"https://github.com/w3c/sensors/pull/290"},"issue":{"href":"https://api.github.com/repos/w3c/sensors/issues/290"},"comments":{"href":"https://api.github.com/repos/w3c/sensors/issues/290/comments"},"review_comments":{"href":"https://api.github.com/repos/w3c/sensors/pulls/290/comments"},"review_comment":{"href":"https://api.github.com/repos/w3c/sensors/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/w3c/sensors/pulls/290/commits"},"statuses":{"href":"https://api.github.com/repos/w3c/sensors/statuses/64067af959e98c2a5d363c87d54fe7279b9b56c7"}},"author_association":"COLLABORATOR"}}
{"actor":{"display_login":"rwaldron"}}