ICANNWiki:Documentation: Difference between revisions

No edit summary
+Documentation/CLS // via Wikitext Extension for VSCode
 
(211 intermediate revisions by 2 users not shown)
Line 1: Line 1:
This meta space for ICANNWiki Content Planning lists resources and concepts that are being worked on or need work performed in them.
{{Note|For content-related matters, please refer to [[ICANNWiki:Content Guide]].}}


==Draft Content Guide for ICANNWiki==
This meta space is dedicated to ICANNWiki documentation, listing features, resources and concepts that are implemented into the project. Useful for maintainers and sysops, primarily.


===Scope===
For our guide for wiki developers on how to avoid Cumulative Layout Shifts (CLS), see: [[ICANNWiki:Documentation/CLS]]


ICANNWiki is concerned with all matters related to Internet Governance, not being limited to ICANN. The scope of this coverage is wide, but should not normally encompass subjects that would already be better covered elsewhere.
==All users==
* '''Video embedding'''
** Provided via [https://www.mediawiki.org/wiki/Extension:EmbedVideo Extension:EmbedVideo].
** Usage: <nowiki>{{#ev:service|id|dimensions|alignment|description|container|urlargs|autoresize|valignment}}</nowiki>
** Example: <nowiki>{{#ev:youtube|mQr3zTKvnyE}}</nowiki> embeds a Youtube video of ICANN 40's opening press conference.


For a clear-cut example, it might be notable to outline that a person comes from a certain geographical region, for example, if they were responsible for bringing Internet connectivity to the Brazilian city of Embu das Artes. In that case, an external link to Wikipedia’s article on [https://en.wikipedia.org/wiki/Embu_das_Artes Embu das Artes] would be ideal, rather than creating an article for ICANNWiki.
*'''Audio embedding'''
** Built-in via MediaWiki.
** Usage: <nowiki>[[File:Name.extension|thumb/frameless|left/center/right|autostart=yes/no|loop=yes/no|start=number|end=number|Caption]]</nowiki>
** Example: <nowiki>[[File:Test.mp3|Test]]</nowiki> embeds a media player for the file.


For a more subjective example, an article on router devices might be better covered by Wikipedia’s article on [https://en.wikipedia.org/wiki/Router_(computing) Router (computing)], although that might not be the case if an ICANNWiki volunteer wants to contribute their expert insights into how this affects Internet Governance. Meanwhile, an article on the practice of routing traffic can be assumed to be better covered by ICANNWiki’s specialized community in our [[Routing]] article.
* '''Mathematics'''
** Provided via [https://www.mediawiki.org/wiki/Extension:Math Extension:Math]
** Usage: <nowiki><math>LaTeX-formatted math expression</math></nowiki>
** Example: <nowiki><math>\frac{1}{2}/math></nowiki> results in <math>\frac{1}{2}</math>.


===Notability===
* '''PDF'''
** Provided via [https://www.mediawiki.org/wiki/Extension:PdfHandler Extension:PdfHandler]
** Usage: PdfHandler display a PDF file like an image, generating thumbnails of its pages.
** Example: <nowiki>[[File:Name.pdf|thumb|page=number|0px|Caption]]</nowiki>


The criteria for notability of an article are that of being relevant to Internet Governance or ICANN in general. The bar is intentionally set lower than Wikipedia in order to accommodate concepts and community members that would not otherwise be a fit to be included there.  
* '''External data'''
** Provided via [https://www.mediawiki.org/wiki/Extension:External_Data Extension:External Data]
** Usage: See [https://www.mediawiki.org/wiki/Extension:External_Data documentation].
** Example:<nowiki>
{{#get_web_data:
|url  = https://example.com/data.json
|format= json
|data  =
  var1 = /key1
  var2 = /key2
}}
Retrieved value: {{#external_value: var1}}
Another value:  {{#external_value: var2}}
</nowiki>


===Style===
* '''Lowercase title'''
** Makes use of [[Template:LowercaseTitle]].
** If the correct version of a page name requires a leading lowercase letter, this template overrides the wiki's standard capitalization behavior on display to the user.
** Usage: <nowiki>{{LowercaseTitle}}</nowiki>


Given the global nature of the ICANNWiki project and the diversity of its users, an academic tone is not expected from contributions. However, a professional tone is required. Usage of slang and stylistics outside of common rules is discouraged exactly to ensure an even playing field for all contributors. This normalization will be enforced by community managers and administrators.
* '''Simpler external linking'''
** Makes use of [[Special:Interwiki]].
** Shortcuts to relevant projects: doi, rfc, wikibooks, wikicities, wikinfo, wikipedia, wikiquote, wikisource, wiktionary.
** Usage: <nowiki>[[rfc:1040]]</nowiki>


In the case of companies, NGOs and other programs, writing must be neutral, without marketing. It is valid to say what a company does and how that is related to Internet Governance or how that company participates in ICANN. That is not to say that a company cannot list its services, but that should not be done as a sales pitch.
===Content templates===
Manual list:
* '''Template:OtherUses'''
** <nowiki>{{OtherUses|TargetPage}}</nowiki>  results in: ''For another use, see TargetPage.''
** <nowiki>{{OtherUses|Page1|Page2|Page3|Page4|Page5}}</nowiki> results in: ''For other uses, see Page1, Page2, Page3, Page4, Page5.''


==Requiring revision/Loose initiatives==
* '''Template:Nosource'''
* [[ICANNWiki Quick Guide]]
** <nowiki>{{nosource|reason=|date=}}</nowiki>
* [[ICANNWiki Murals]]
* [[City Guides]]
* [[Caricature Badges]]
* [[T-Shirts]]
* [[Sponsorship Options]]
* [[ICANN Historical Timeline]]
* [[ICANNWiki:Community_portal]]
* [[Translation Sandbox]]
* [[TL Test BarData]]
* [[TL test]]
* [[Proposed Interim GDPR Compliance Model]]
* [[ALAC Timeline]]
* [[:Category: Getting started]]


==Resources==
===Needed pages trackers===
===Pages===
* [[Special:WantedCategories]]
* [[Special:AllPages]]
* [[Special:WantedPages]]
* [[Special:LonelyPages]]
* [https://icannwiki.org/index.php?title=Special:DeadendPages&limit=500&offset=0 Special:DeadendPages]
* [https://icannwiki.org/index.php?title=Special:LongPages&limit=2500&offset=0 Special:LongPages]
* [[Special:MostLinkedPages]]
* [https://icannwiki.org/index.php?title=Special:PopularPages&limit=2500&offset=0 Special:PopularPages]
* [https://icannwiki.org/index.php?title=Special:ListRedirects&limit=2500&offset=0 Special:ListRedirects]


===Categories===
===Semi-automated wiki maintenance===
* [https://icannwiki.org/index.php?title=Special:Categories&offset=&limit=1000 Special:Categories]
These self-updating pages point to varied issues in the wiki that need fixing at a given point in time.
* [https://icannwiki.org/index.php?title=Special:UncategorizedPages&limit=500&offset=0 Special:UncategorizedPages]
* [[:Category:Pages with broken file links]]
* [[Special:MostLinkedCategories]]
* [[:Category:Pages using duplicate arguments in template calls]]
* [[:Category:Pages with reference errors]]
* [[Special:UnusedFiles]]
* [[Special:ListDuplicatedFiles]]
* [[Special:BrokenRedirects]]
* [[Special:DoubleRedirects]]
* [[Special:UncategorizedPages]]
* [[Special:WantedFiles]]
* [[Special:WantedTemplates]]
* [[Special:UnusedCategories]]
* When our Lua templates fail to recognize a string, they generate an entry in: [[:Category:(Unrecognized)]]
** A more complete list with less relevant indicators can be found at: [[Special:TrackingCategories]]


===Users===
===ICANNWiki's presence elsewhere===
* [[Special:ListUsers]]
* [https://en.wikipedia.org/wiki/ICANNWiki ICANNWiki on Wikipedia]
* [[Special:ActiveUsers]]
* [https://en.wikipedia.org/wiki/List_of_wikis ICANNWiki on Wikipedia's list of wikis]
* [https://www.instagram.com/icannwiki/ ICANNWiki on Instagram]
* [https://www.linkedin.com/company/icannwiki/ ICANNWiki on LinkedIn]
* [https://www.facebook.com/ICANNWiki ICANNWiki on Facebook]


===Technical===
==SysOps and devs==
* [[Special:SpecialPages]]
 
* [[Special:Statistics]]
===Information===
* [[Special:Version]]
 
====Critical resources====
* '''Mediawiki installation data''': [[Special:Version]]
* '''Mediawiki metadata (API-JSON)''': [https://icannwiki.org/api.php?action=query&meta=siteinfo&format=json]
* '''Master actions log''': [[Special:Log]]
* '''Complete user list''': [[Special:ListUsers]] and the subset [[Special:ActiveUsers]]
* Indexing of '''[[Special:ListGrants]]'''
* Indexing of '''[[Special:ListGroupRights]]''' with "Namespace restrictions"
* '''User registration''' is manually reviewed to combat abuse using [[Special:ConfirmAccounts]].
* '''User investigation''', including email accounts, can be carried out with [[Special:UserInformation]] (exercise discernment).
 
====System inspection====
* '''Wiki-wide statistics''': [[Special:Statistics]]
* '''List Namespaces''': [[Special:NamespaceInfo]]
* '''List pages by Namespace''': [[Special:PrefixIndex]]
* '''List pages by properties''': [[Special:PagesWithProp]] (like "hiddencat", not semantics related)
* '''Meta information about pages''': [[Special:PageInfo]]
* '''Review all page protections''': [[Special:ProtectedPages]]
* '''Search files by extension''' [[Special:MIMESearch]] and '''see relevant extension statistics''' [[Special:MediaStatistics]]
 
===Structure===
{| class="wikitable"
|+
| Favicon || [[:File:Favicon.ico]] and [[:File:Favicon.svg]]
|-
| Change page content model || [[Special:ChangeContentModel]] (such as CSS, JSON, Wikitext, etc.)
|-
| Merge page histories || [[Special:MergeHistory]]
|-
| Debug output to browser console || Append '''<nowiki>?debug=true</nowiki>''' to the end of the URL
|-
| Expose element names in pages || append '''<nowiki>?uselang=qqx</nowiki>''' to the end of the URL
|-
| Fetch the raw version of a file from the wiki || append '''<nowiki>?action=raw</nowiki>''' to the end of the URL
|-
| Access article by its ID || '''<nowiki>https://icannwiki.org/index.php?curid=NUMBER</nowiki>''' Replace NUMBER with the page's ID
|}
 
===Actions===
{| class="wikitable"
|+
! Extension !! Description !! Comments
|-
| [[Special:CheckUser]] || Displays technical information about a user || [https://www.mediawiki.org/wiki/Extension:CheckUser Extension:CheckUser]
|-
| [[Special:Nuke]] || Mass deletion tool; recent changes only || Irreversible
|-
| [[Special:ReplaceText]] || Perform regex/text replacements across the entire wiki || Shows preview before acting
|-
| [[Special:BatchUpload]] || Batch file uploading || [https://www.mediawiki.org/wiki/Extension:SimpleBatchUpload Extension:SimpleBatchUpload]
|-
| [[Special:AbuseFilter]] || Triggers actions on edits matching defined patterns || [https://www.mediawiki.org/wiki/Extension:AbuseFilter Extension:AbuseFilter] Can auto-warn, block, or tag edits; requires filter definitions
|-
| Captchas || Reliant on [https://www.mediawiki.org/wiki/Extension:ConfirmEdit Extension:ConfirmEdit] || Customizable
|-
| [https://www.mediawiki.org/wiki/Extension:Approved_Revs Extension:Approved Revs] || Can mark a revision as “approved” for default view || Controls what revision the general public sees
|-
| [https://www.mediawiki.org/wiki/Extension:SpamBlacklist Extension:SpamBlacklist] || Whitelist/blacklist URLs and email addresses || Configured via: [[MediaWiki:Spam-blacklist]], [[MediaWiki:Spam-whitelist]], [[MediaWiki:Email-blacklist]], [[MediaWiki:Email-whitelist]]
|}
 
===System messages===
{| class="wikitable"
|+
! Feature !! Source
|-
|Change system messages || [[Special:AllMessages]]
|-
| Left-hand sidebar || [[MediaWiki:Sidebar]]
|-
| Right-hand sidebar || CSS exclusion of IDs in [[MediaWiki:Common.css]]
|-
| Welcome message || Upon account confirmation: [[MediaWiki:Confirmaccount-welc]]
|-
| Message to blocked users || [[MediaWiki:Blockedtext]]
|-
| Upload page instructions || [[MediaWiki:Uploadtext]]
|-
|}
 
====Our customized messages====
Automated list:
<div class="mw-allpages-body">
<DPL>
namespace=MediaWiki
ordermethod=title
order=ascending
redirects=exclude
mode=unordered
nottitlematch=%.js%
nottitlematch=%.css%
nottitlematch=%smw-
</DPL>
</div>
 
===Acronym tooltips===
* Makes use of [https://www.mediawiki.org/wiki/Extension:Lingo Extension:Lingo]
** Usage: The extension takes acronyms and their definitions from the [[Terminology]] article. The rendering of all tooltips on an article can be prevented with the magic word: <nowiki>__NOGLOSSARY__</nowiki>. To prevent tooltips only within a section, use: <nowiki><noglossary>Content</noglossary></nowiki>.
** Our syntax is: <nowiki>;ACRONYM:[[Internal Link]]. Brief description as per the most canonical source available, such as the ICANN Bylaws (''Source'').</nowiki>
** Note: Pluralization is not natively supported by the extension, and acronyms with potential plural forms need to be declared manually.
 
===Page Notice===
* Provided via [https://www.mediawiki.org/wiki/Extension:PageNotice Extension:PageNotice].
* Usage: The syntax is "MediaWiki:''Bottom''/''Top''-notice-''ns-0''/''name''", where a page is created with either the Bottom or Top allocation, and for display either a namespace is chosen by its number, or a name string for a page is specified.
* Currently active (manual list):
** [[MediaWiki:Bottom-notice-ns-0]]: Main Namespace
** [[MediaWiki:Bottom-notice-ns-4]]: ICANNWiki Namespace
** [[MediaWiki:Top-notice-ns-2]]: User Namespace
** [[MediaWiki:Top-notice-ns-102]]: Property Namespace
 
===Semantics-related===
* [[Special:ProcessingErrorList]]
* [[Special:Categories]]
* [https://www.semantic-mediawiki.org/wiki/Help:Special_properties List of applicable Special properties]
 
===Gadgets===
Gadgets are powerful self-contained JS actions that are loaded ahead of [[MediaWiki:Common.js]], being loaded almost in tandem with the DOM. They need to be declared individually in [[MediaWiki:Gadgets-definition]], and the most useful arguments to use with them are "default" (which effectively turns them into a ResourceLoader) and "hidden" (cannot be disabled by users).
* '''List''': [[Special:Gadgets]]
* '''Usage''': [[Special:GadgetUsage]]
 
==List of Lua modules==
Automated list:
{{Special:AllPages/Module:}}
 
==List of semantic properties==
Automated list:
{{Special:AllPages/Property:}}
 
==External resources==
===Magic words===
* [https://en.wikipedia.org/wiki/Help:Magic_words Help:Magic words]: Magic words list
** <nowiki>{{NAMESPACENUMBER}}</nowiki>
** <nowiki>{{NUMBEROFARTICLES}}</nowiki>
 
===MediaWiki Customization===
* [https://en.wikipedia.org/wiki/Wikipedia:Customisation#Tidying_up_the_user_interface Tidying up the user interface]
 
===Fandom===
* [https://dev.fandom.com/wiki/Global_Lua_Modules Global Lua Modules]
* [https://dev.fandom.com/wiki/JavaScript_Cookbook JavaScript Cookbook]
* [https://dev.fandom.com/wiki/List_of_JavaScript_enhancements JavaScript enhancements]
 
<!-- Categories -->
[[Category:ICANNWiki]]