Review URL: https://codereview.webrtc.org/1570473002 Cr-Commit-Position: refs/heads/master@{#11163}
And add examples of good and bad usage to the documentation. R=aluebs@webrtc.org, henrik.lundin@webrtc.org, pthatcher@webrtc.org Review URL: https://codereview.webrtc.org/1432553007 . Cr-Commit-Position: refs/heads/master@{#10588}