{"action":"created","comment":{"url":"https://api.github.com/repos/mixxxdj/manual/pulls/comments/43309318","id":43309318,"diff_hunk":"@@ -666,15 +693,34 @@ Equalizers and Gain Knobs\n    EQ Controls\n \n **Gain Knob**\n-  Above these knobs, the gain knob allows you to adjust the gain of the deck. In\n-  general, you should adjust this knob so that at full-volume the deck's audio\n-  is just at the peak of the center VU meters. This is so you can achieve the\n-  widest dynamic range for your track.\n+  Above these knobs, the gain knob allows you to adjust the gain of the deck. \n+  Use this to compensate for the differences in recording levels between tracks.\n+  In general, you should adjust this knob so that the track's :term:`level meter`\n+  stays around the top of the green region with the loudest parts of the track\n+  (the transients) briefly going into the yellow region. **Do NOT turn the\n+  Gain Knob up so much that the level meter is in the red region. At this point\n+  the track is clipping, which sounds bad and could damage equipment.**\n+  \n+  .. seealso:: For a more in depth explanation of how to set your gains, see\n+               :ref:`Setting your levels properly (gain staging) <djing-gain-staging>`.\n+  \n+  .. note:: By default, Mixxx automatically applies an additional ReplayGain so","path":"source/chapters/user_interface.rst","position":145,"original_position":145,"commit_id":"526b1eaf64c65c917d6ebf1493e7be159f2cbe1c","original_commit_id":"526b1eaf64c65c917d6ebf1493e7be159f2cbe1c","user":{"login":"daschuer","id":1777442,"avatar_url":"https://avatars.githubusercontent.com/u/1777442?v=3","gravatar_id":"","url":"https://api.github.com/users/daschuer","html_url":"https://github.com/daschuer","followers_url":"https://api.github.com/users/daschuer/followers","following_url":"https://api.github.com/users/daschuer/following{/other_user}","gists_url":"https://api.github.com/users/daschuer/gists{/gist_id}","starred_url":"https://api.github.com/users/daschuer/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/daschuer/subscriptions","organizations_url":"https://api.github.com/users/daschuer/orgs","repos_url":"https://api.github.com/users/daschuer/repos","events_url":"https://api.github.com/users/daschuer/events{/privacy}","received_events_url":"https://api.github.com/users/daschuer/received_events","type":"User","site_admin":false},"body":"I would put these notes above \"seealso\"","created_at":"2015-10-28T19:59:31Z","updated_at":"2015-10-28T19:59:31Z","html_url":"https://github.com/mixxxdj/manual/pull/37#discussion_r43309318","pull_request_url":"https://api.github.com/repos/mixxxdj/manual/pulls/37","_links":{"self":{"href":"https://api.github.com/repos/mixxxdj/manual/pulls/comments/43309318"},"html":{"href":"https://github.com/mixxxdj/manual/pull/37#discussion_r43309318"},"pull_request":{"href":"https://api.github.com/repos/mixxxdj/manual/pulls/37"}}},"pull_request":{"url":"https://api.github.com/repos/mixxxdj/manual/pulls/37","id":40786711,"html_url":"https://github.com/mixxxdj/manual/pull/37","diff_url":"https://github.com/mixxxdj/manual/pull/37.diff","patch_url":"https://github.com/mixxxdj/manual/pull/37.patch","issue_url":"https://api.github.com/repos/mixxxdj/manual/issues/37","number":37,"state":"open","locked":false,"title":"replace \"volume\" with \"gain\" and explain how to adjust gain properly","user":{"login":"Be-ing","id":9455094,"avatar_url":"https://avatars.githubusercontent.com/u/9455094?v=3","gravatar_id":"","url":"https://api.github.com/users/Be-ing","html_url":"https://github.com/Be-ing","followers_url":"https://api.github.com/users/Be-ing/followers","following_url":"https://api.github.com/users/Be-ing/following{/other_user}","gists_url":"https://api.github.com/users/Be-ing/gists{/gist_id}","starred_url":"https://api.github.com/users/Be-ing/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/Be-ing/subscriptions","organizations_url":"https://api.github.com/users/Be-ing/orgs","repos_url":"https://api.github.com/users/Be-ing/repos","events_url":"https://api.github.com/users/Be-ing/events{/privacy}","received_events_url":"https://api.github.com/users/Be-ing/received_events","type":"User","site_admin":false},"body":"This should alleviate https://bugs.launchpad.net/mixxx/+bug/1458677","created_at":"2015-07-24T15:30:28Z","updated_at":"2015-10-28T19:59:31Z","closed_at":null,"merged_at":null,"merge_commit_sha":"9fe5961ce14e48fb8cb6625bf9de42d0e2114993","assignee":null,"milestone":null,"commits_url":"https://api.github.com/repos/mixxxdj/manual/pulls/37/commits","review_comments_url":"https://api.github.com/repos/mixxxdj/manual/pulls/37/comments","review_comment_url":"https://api.github.com/repos/mixxxdj/manual/pulls/comments{/number}","comments_url":"https://api.github.com/repos/mixxxdj/manual/issues/37/comments","statuses_url":"https://api.github.com/repos/mixxxdj/manual/statuses/526b1eaf64c65c917d6ebf1493e7be159f2cbe1c","head":{"label":"Be-ing:gain","ref":"gain","sha":"526b1eaf64c65c917d6ebf1493e7be159f2cbe1c","user":{"login":"Be-ing","id":9455094,"avatar_url":"https://avatars.githubusercontent.com/u/9455094?v=3","gravatar_id":"","url":"https://api.github.com/users/Be-ing","html_url":"https://github.com/Be-ing","followers_url":"https://api.github.com/users/Be-ing/followers","following_url":"https://api.github.com/users/Be-ing/following{/other_user}","gists_url":"https://api.github.com/users/Be-ing/gists{/gist_id}","starred_url":"https://api.github.com/users/Be-ing/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/Be-ing/subscriptions","organizations_url":"https://api.github.com/users/Be-ing/orgs","repos_url":"https://api.github.com/users/Be-ing/repos","events_url":"https://api.github.com/users/Be-ing/events{/privacy}","received_events_url":"https://api.github.com/users/Be-ing/received_events","type":"User","site_admin":false},"repo":{"id":37041976,"name":"manual","full_name":"Be-ing/manual","owner":{"login":"Be-ing","id":9455094,"avatar_url":"https://avatars.githubusercontent.com/u/9455094?v=3","gravatar_id":"","url":"https://api.github.com/users/Be-ing","html_url":"https://github.com/Be-ing","followers_url":"https://api.github.com/users/Be-ing/followers","following_url":"https://api.github.com/users/Be-ing/following{/other_user}","gists_url":"https://api.github.com/users/Be-ing/gists{/gist_id}","starred_url":"https://api.github.com/users/Be-ing/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/Be-ing/subscriptions","organizations_url":"https://api.github.com/users/Be-ing/orgs","repos_url":"https://api.github.com/users/Be-ing/repos","events_url":"https://api.github.com/users/Be-ing/events{/privacy}","received_events_url":"https://api.github.com/users/Be-ing/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/Be-ing/manual","description":"The Mixxx Manual","fork":true,"url":"https://api.github.com/repos/Be-ing/manual","forks_url":"https://api.github.com/repos/Be-ing/manual/forks","keys_url":"https://api.github.com/repos/Be-ing/manual/keys{/key_id}","collaborators_url":"https://api.github.com/repos/Be-ing/manual/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/Be-ing/manual/teams","hooks_url":"https://api.github.com/repos/Be-ing/manual/hooks","issue_events_url":"https://api.github.com/repos/Be-ing/manual/issues/events{/number}","events_url":"https://api.github.com/repos/Be-ing/manual/events","assignees_url":"https://api.github.com/repos/Be-ing/manual/assignees{/user}","branches_url":"https://api.github.com/repos/Be-ing/manual/branches{/branch}","tags_url":"https://api.github.com/repos/Be-ing/manual/tags","blobs_url":"https://api.github.com/repos/Be-ing/manual/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/Be-ing/manual/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/Be-ing/manual/git/refs{/sha}","trees_url":"https://api.github.com/repos/Be-ing/manual/git/trees{/sha}","statuses_url":"https://api.github.com/repos/Be-ing/manual/statuses/{sha}","languages_url":"https://api.github.com/repos/Be-ing/manual/languages","stargazers_url":"https://api.github.com/repos/Be-ing/manual/stargazers","contributors_url":"https://api.github.com/repos/Be-ing/manual/contributors","subscribers_url":"https://api.github.com/repos/Be-ing/manual/subscribers","subscription_url":"https://api.github.com/repos/Be-ing/manual/subscription","commits_url":"https://api.github.com/repos/Be-ing/manual/commits{/sha}","git_commits_url":"https://api.github.com/repos/Be-ing/manual/git/commits{/sha}","comments_url":"https://api.github.com/repos/Be-ing/manual/comments{/number}","issue_comment_url":"https://api.github.com/repos/Be-ing/manual/issues/comments{/number}","contents_url":"https://api.github.com/repos/Be-ing/manual/contents/{+path}","compare_url":"https://api.github.com/repos/Be-ing/manual/compare/{base}...{head}","merges_url":"https://api.github.com/repos/Be-ing/manual/merges","archive_url":"https://api.github.com/repos/Be-ing/manual/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/Be-ing/manual/downloads","issues_url":"https://api.github.com/repos/Be-ing/manual/issues{/number}","pulls_url":"https://api.github.com/repos/Be-ing/manual/pulls{/number}","milestones_url":"https://api.github.com/repos/Be-ing/manual/milestones{/number}","notifications_url":"https://api.github.com/repos/Be-ing/manual/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/Be-ing/manual/labels{/name}","releases_url":"https://api.github.com/repos/Be-ing/manual/releases{/id}","created_at":"2015-06-08T02:33:38Z","updated_at":"2015-06-08T02:33:38Z","pushed_at":"2015-10-28T16:24:33Z","git_url":"git://github.com/Be-ing/manual.git","ssh_url":"git@github.com:Be-ing/manual.git","clone_url":"https://github.com/Be-ing/manual.git","svn_url":"https://github.com/Be-ing/manual","homepage":null,"size":13803,"stargazers_count":0,"watchers_count":0,"language":"Python","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":"manual"}},"base":{"label":"mixxxdj:manual","ref":"manual","sha":"03fa849b14b887b7c9413fc1e1ecc9047a72a9ce","user":{"login":"mixxxdj","id":1743769,"avatar_url":"https://avatars.githubusercontent.com/u/1743769?v=3","gravatar_id":"","url":"https://api.github.com/users/mixxxdj","html_url":"https://github.com/mixxxdj","followers_url":"https://api.github.com/users/mixxxdj/followers","following_url":"https://api.github.com/users/mixxxdj/following{/other_user}","gists_url":"https://api.github.com/users/mixxxdj/gists{/gist_id}","starred_url":"https://api.github.com/users/mixxxdj/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/mixxxdj/subscriptions","organizations_url":"https://api.github.com/users/mixxxdj/orgs","repos_url":"https://api.github.com/users/mixxxdj/repos","events_url":"https://api.github.com/users/mixxxdj/events{/privacy}","received_events_url":"https://api.github.com/users/mixxxdj/received_events","type":"Organization","site_admin":false},"repo":{"id":12713164,"name":"manual","full_name":"mixxxdj/manual","owner":{"login":"mixxxdj","id":1743769,"avatar_url":"https://avatars.githubusercontent.com/u/1743769?v=3","gravatar_id":"","url":"https://api.github.com/users/mixxxdj","html_url":"https://github.com/mixxxdj","followers_url":"https://api.github.com/users/mixxxdj/followers","following_url":"https://api.github.com/users/mixxxdj/following{/other_user}","gists_url":"https://api.github.com/users/mixxxdj/gists{/gist_id}","starred_url":"https://api.github.com/users/mixxxdj/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/mixxxdj/subscriptions","organizations_url":"https://api.github.com/users/mixxxdj/orgs","repos_url":"https://api.github.com/users/mixxxdj/repos","events_url":"https://api.github.com/users/mixxxdj/events{/privacy}","received_events_url":"https://api.github.com/users/mixxxdj/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/mixxxdj/manual","description":"The Mixxx Manual","fork":false,"url":"https://api.github.com/repos/mixxxdj/manual","forks_url":"https://api.github.com/repos/mixxxdj/manual/forks","keys_url":"https://api.github.com/repos/mixxxdj/manual/keys{/key_id}","collaborators_url":"https://api.github.com/repos/mixxxdj/manual/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/mixxxdj/manual/teams","hooks_url":"https://api.github.com/repos/mixxxdj/manual/hooks","issue_events_url":"https://api.github.com/repos/mixxxdj/manual/issues/events{/number}","events_url":"https://api.github.com/repos/mixxxdj/manual/events","assignees_url":"https://api.github.com/repos/mixxxdj/manual/assignees{/user}","branches_url":"https://api.github.com/repos/mixxxdj/manual/branches{/branch}","tags_url":"https://api.github.com/repos/mixxxdj/manual/tags","blobs_url":"https://api.github.com/repos/mixxxdj/manual/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/mixxxdj/manual/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/mixxxdj/manual/git/refs{/sha}","trees_url":"https://api.github.com/repos/mixxxdj/manual/git/trees{/sha}","statuses_url":"https://api.github.com/repos/mixxxdj/manual/statuses/{sha}","languages_url":"https://api.github.com/repos/mixxxdj/manual/languages","stargazers_url":"https://api.github.com/repos/mixxxdj/manual/stargazers","contributors_url":"https://api.github.com/repos/mixxxdj/manual/contributors","subscribers_url":"https://api.github.com/repos/mixxxdj/manual/subscribers","subscription_url":"https://api.github.com/repos/mixxxdj/manual/subscription","commits_url":"https://api.github.com/repos/mixxxdj/manual/commits{/sha}","git_commits_url":"https://api.github.com/repos/mixxxdj/manual/git/commits{/sha}","comments_url":"https://api.github.com/repos/mixxxdj/manual/comments{/number}","issue_comment_url":"https://api.github.com/repos/mixxxdj/manual/issues/comments{/number}","contents_url":"https://api.github.com/repos/mixxxdj/manual/contents/{+path}","compare_url":"https://api.github.com/repos/mixxxdj/manual/compare/{base}...{head}","merges_url":"https://api.github.com/repos/mixxxdj/manual/merges","archive_url":"https://api.github.com/repos/mixxxdj/manual/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/mixxxdj/manual/downloads","issues_url":"https://api.github.com/repos/mixxxdj/manual/issues{/number}","pulls_url":"https://api.github.com/repos/mixxxdj/manual/pulls{/number}","milestones_url":"https://api.github.com/repos/mixxxdj/manual/milestones{/number}","notifications_url":"https://api.github.com/repos/mixxxdj/manual/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/mixxxdj/manual/labels{/name}","releases_url":"https://api.github.com/repos/mixxxdj/manual/releases{/id}","created_at":"2013-09-09T21:22:24Z","updated_at":"2015-05-05T07:19:48Z","pushed_at":"2015-10-28T16:24:34Z","git_url":"git://github.com/mixxxdj/manual.git","ssh_url":"git@github.com:mixxxdj/manual.git","clone_url":"https://github.com/mixxxdj/manual.git","svn_url":"https://github.com/mixxxdj/manual","homepage":null,"size":14220,"stargazers_count":3,"watchers_count":3,"language":"Python","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":9,"mirror_url":null,"open_issues_count":17,"forks":9,"open_issues":17,"watchers":3,"default_branch":"manual"}},"_links":{"self":{"href":"https://api.github.com/repos/mixxxdj/manual/pulls/37"},"html":{"href":"https://github.com/mixxxdj/manual/pull/37"},"issue":{"href":"https://api.github.com/repos/mixxxdj/manual/issues/37"},"comments":{"href":"https://api.github.com/repos/mixxxdj/manual/issues/37/comments"},"review_comments":{"href":"https://api.github.com/repos/mixxxdj/manual/pulls/37/comments"},"review_comment":{"href":"https://api.github.com/repos/mixxxdj/manual/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/mixxxdj/manual/pulls/37/commits"},"statuses":{"href":"https://api.github.com/repos/mixxxdj/manual/statuses/526b1eaf64c65c917d6ebf1493e7be159f2cbe1c"}}}}