diff --git a/CODE_OF_ETHICS.md b/CODE_OF_ETHICS.md index db30a78..a5972de 100644 --- a/CODE_OF_ETHICS.md +++ b/CODE_OF_ETHICS.md @@ -18,18 +18,18 @@ Some netizens respond to this by installing Ad Blockers, which treat the symptom > 👌 A Wikipedia entry about lightbulbs covers their invention, linking to Thomas Edison's entry. -1. Comment threads should be a shorter read than the material they're commenting on. Comment threads have incredibly low information density and quickly veer off topic. They will grow boundlessly and overshadow your main content. +2. Comment threads should be a shorter read than the material they're commenting on. Comment threads have incredibly low information density and quickly veer off topic. They will grow boundlessly and overshadow your main content. - > ❌ Dark-pattern: The best rated reply of a Hacker News thread has 100 sub-replies, which are all shown before the second best rated reply. + > ❌ Dark-pattern: The best rated reply to an entry on Hacker News has 100 sub-replies, which are all shown before the second best rated reply. > 👌 The comments at the bottom of a Kotaku blog post are hidden by default until approved by a moderator. ### B. Visitors should make decisions free from social influence. -1. Do not publish vanity metrics about visitors or content. These may cause visitors to join a rat race or engage with content just to see what the fuss is about. +1. Do not publish vanity metrics about visitors or content. These may cause visitors to start comparing themselves or engage with content just to see what the fuss is about. > ❌ Dark-pattern: A karma count is displayed in the site header at the top of every Reddit page. > ❌ Dark-pattern: Twitter prominently displays a like count and a retweet count on every tweet. - > ❌ Dark-pattern: The Washington Post tells you how many comments are in a thread + > ❌ Dark-pattern: The Washington Post tells you how many comments are in a thread. diff --git a/src/hacker-news/collapse-deep-comments.js b/src/hacker-news/collapse-deep-comments.js index eabc7a8..760c99e 100644 --- a/src/hacker-news/collapse-deep-comments.js +++ b/src/hacker-news/collapse-deep-comments.js @@ -10,6 +10,7 @@ const COMMENT_COLLAPSE_DEPTH = 1; /** * Collapse all comments starting at a certain depth. 0-indexed + * @see A.2 * @type {Number} depth */ (function collapseDeepComments (depth) { diff --git a/src/hacker-news/collapse-low-quality-comments.js b/src/hacker-news/collapse-low-quality-comments.js index 12b4eeb..7f2355b 100644 --- a/src/hacker-news/collapse-low-quality-comments.js +++ b/src/hacker-news/collapse-low-quality-comments.js @@ -1,5 +1,6 @@ /** * Collapse all comments HN has already deemed lower quality + * @see A.2 */ (function collapseLowQualityComments () { document.querySelectorAll('tr.athing.comtr').forEach((comment) => { diff --git a/src/hacker-news/remove-comment-count.js b/src/hacker-news/remove-comment-count.js index b8e6a4c..2f833b3 100644 --- a/src/hacker-news/remove-comment-count.js +++ b/src/hacker-news/remove-comment-count.js @@ -1,5 +1,6 @@ /** * Remove the count from the comments link on each post + * @see B.1 */ (function removeCommentCount () { document.querySelectorAll('td.subtext > a:last-child').forEach((comments) => { diff --git a/src/hacker-news/remove-comment-karma.js b/src/hacker-news/remove-comment-karma.js index 7f73c6d..c80faef 100644 --- a/src/hacker-news/remove-comment-karma.js +++ b/src/hacker-news/remove-comment-karma.js @@ -1,6 +1,7 @@ /** * Remove karma totals next to comments (typically seen next to your own comments when * logged in) + * @see B.1 */ (function removeCommentKarma () { document.querySelectorAll('span[id^="score_"]').forEach((score) => { diff --git a/src/hacker-news/remove-post-karma.js b/src/hacker-news/remove-post-karma.js index 3c75957..116ab42 100644 --- a/src/hacker-news/remove-post-karma.js +++ b/src/hacker-news/remove-post-karma.js @@ -1,5 +1,6 @@ /** * Remove all the karma totals underneath each post + * @see B.1 */ (function removePostKarma () { document.querySelectorAll('td.subtext span.score').forEach((points) => { diff --git a/src/hacker-news/remove-profile-karma.js b/src/hacker-news/remove-profile-karma.js index bd9129c..0b845ce 100644 --- a/src/hacker-news/remove-profile-karma.js +++ b/src/hacker-news/remove-profile-karma.js @@ -1,5 +1,6 @@ /** * Remove karma count from user profiles + * @see B.1 */ (function removeProfileKarma () { document.querySelectorAll('td[valign="top"]').forEach((td) => { diff --git a/src/hacker-news/remove-self-karma.js b/src/hacker-news/remove-self-karma.js index 77d9bc9..214fe5d 100644 --- a/src/hacker-news/remove-self-karma.js +++ b/src/hacker-news/remove-self-karma.js @@ -1,5 +1,6 @@ /** * Remove the logged in user's karma from the page header + * @see B.1 */ (function removeSelfKarma () { const self = document.querySelector('a#me')