User:SuperHamster/CiteUnseen (WP:CITEUNSEEN)

Cite Unseen is a user script that adds categorical icons to Wikipedia citations, providing readers and editors a quick initial evaluation of citations at a glance. This helps guide users on the nature and reliability of sources, and to help identify sources that may potentially be problematic or should be used with caution (key word is may - see the usage guide below). Cite Unseen's categorization dataset currently holds over 3,400 domains in 18 categories. These categories include:  Perennial sources list statuses (generally reliable; marginally reliable; generally unreliable; deprecated; blacklisted) Advocacy groups; books; blogs; user-generated news; editable sites; state media; news; opinion pieces; press releases; social media sites; tabloids; and TV and radio programs Predatory journals listed on the predatory source listInitially developed at CredCon in November 2018, Cite Unseen was jointly developed by Kevin Payravi (SuperHamster) and Josh Lim (Sky Harbor), with support from the Credibility Coalition and the Knowledge Graph Working Group. The project saw more development at Wikimedia Hackathon 2019.   == Installation ==  The script is located at User:SuperHamster/CiteUnseen.js. You can add the script to your Wikipedia browsing experience by editing your common.js file and adding the following line:  {{subst:iusc|User:SuperHamster/CiteUnseen.js}}  Cite Unseen will automatically run whenever you open a Wikipedia page. Before using, please read the usage guidelines below. It's particularly important to keep in mind that while Cite Unseen is here to guide you, it does not evaluate context and should not justify editing decisions.   === Configuration === By default, all icon types will be shown except for resources that are considered generally reliable per the perennial sources list, to reduce clutter. You can toggle icons on or off by pasting the following in your CiteUnseen-Rules.js page, and adjusting the true/false values however you wish.  cite_unseen_ruleset = {   "advocacy": true,   "blogs": true,   "books": true,   "community": true,   "editable": true,   "government": true,   "news": true,   "opinions": true,   "predatory": true,   "press": true,   "rspDeprecated": true,   "rspBlacklisted": true,   "rspGenerallyUnreliable": true,   "rspMarginallyReliable": true,   "rspGenerallyReliable": false,   "rspMulti": true,   "social": true,   "tabloids": true }   == Usage ==  Once installed, Cite Unseen will automatically analyze and annotate references you come across. When it finds a match in its categorization dataset, it will add a categorical icon (refer to the chart below). You can hover over an icon to get more details about the categorization. Important points to keep in mind while using Cite Unseen:  Context matters. Sources that are considered generally unreliable can still have valid use. For example, while we typically avoid citing social media, social media posts may still be used for uncontroversial self-descriptions. And while we typically try to avoid self-published blogs and other user-generated content, they may still be acceptable when authored by established subject-matter experts (see WP:SPS for more). Evaluate. The point of Cite Unseen is to highlight the nature of sources, and to prompt you to think about potential concerns with a source. Just because a source has a concerning mark does not automatically mean it is being used inappropriately. You should never justify removing or adding a source solely because of information that Cite Unseen provides; you need to do your own homework as well. It does not cover everything. There is an endless trove of resources out there, and we can't categorize all of them. You'll find many citations that Cite Unseen won't mark up; this does not indicate anything other than that it either (a) does not fit in an existing category or (b) more commonly, it simply hasn't been categorized. It is not always right. Cite Unseen looks at citation types and does string-matching against URLs. While generally successful, it's possible for Cite Unseen to misidentify a source. Sometimes reliable sources are hosted on an unreliable site. For example, editors citing a book may link to its listing on Amazon.com, which is classified as  generally unreliable. This will cause the citation to be marked as generally unreliable even if the book itself is fine. Situations like these are something to keep in mind while investigating the usage of a source.   === Classifications === Cite Unseen classifies sources into eighteen categories.   == Contributing == We're always looking to expand and tune our categorizations. Please place any questions or ideas on the talk page. If you're interested in touching the code itself:  GitHub Repository categorized-domains.json (for categorized domains) categorized-strings.json (for categorized non-domain strings) Phabricator Board   === Next steps === Some of the next big goals for the project:  Expand our lists of identified domains In particular, news sites and government-controlled sources Wikipedia:WikiProject Albums/Sources (WP:A/S) (music-related sources) Wikipedia:WikiProject Video games/Sources (WP:VG/S) (video game sources) The Wikipedia CiteWatch (WP:CITEWATCH) Wikipedia:New page patrol source guide (WP:NPPSG) (sources encountered by new page patrollers) Support multiple language versions of Wikipedia   == Technical implementation == Cite Unseen performs string matching on URLs, as well as checks for different types of citation templates, in order to identify the kind of work and any potential ideological leanings. Cite Unseen is implemented in JavaScript. When Cite Unseen is run, it does the following:  Iterates through every citation in a given Wikipedia article and pulls URLs. Checks each URL against a pre-defined list of domains and strings that are categorized by nature (biased, press, news, opinion piece, etc.). Injects icons next to citations accordingly.   == See also == Perennial sources list on Wikipedia, documenting community consensus on the reliability of sources. The Sourceror API by User:Newslinger, delivering the perennial sources list in structured format. User:Headbomb/unreliable, another user script that highlights links based on the perennial sources list, {{Predatory open access source list}}, and WP:CITEWATCH.