Jump to content

ICANNWiki:Documentation: Difference between revisions

From ICANNWiki
← Older edit
VisualWikitext
 
(70 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.
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.


==Draft Content Guide for ICANNWiki==
==Content Guide for ICANNWiki==
 
Please refer to [[ICANNWiki:Content Guide]].
===Scope===
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.
 
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.
 
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.
 
===Style===
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 language rules is discouraged exactly to ensure an even playing field for all contributors. This normalization will be enforced by community managers and administrators.
 
The main language of the wiki is English, and any variant of that language is accepted, with spellings such as ''color'' and ''colour'' being equally valid and with no need to normalize them. Our focus is on stabilizing the main version of the wiki before branching out to other languages, but exceptions can be made if they are coordinated with administrators.
 
In the case of companies, NGOs, and programs, the writing of materials relating to their work must be neutral, without marketing products or services. It is valid and welcome to state what an entity does and how that is related to Internet Governance or how that entity participates in ICANN. Entities are allowed to list their services, but that should not be done as a sales pitch. Occurrences of blatant marketing posting will be moderated.
 
===Notability===
The criteria for notability of an article are that of being relevant to Internet Governance or ICANN in general, without the need for further qualification as long as that connection is firmly established. The bar is intentionally set lower than that of Wikipedia in order to accommodate concepts and community members that would not otherwise be fit to be included there.
 
==Standardization==
* '''ICANN Meetings''': ICANN {Number with leading zero} (as the main page) + ICANN {Number with leading zero} - {Location as spelled by ICANN} (as a redirect)
:''Example'': [[ICANN 41]] (root) and [[ICANN 41 - Singapore]] (redirect).
* '''Internet Society (ISOC) Chapters''': Internet Society {Country Name} Chapter
:''Example'': [[Internet Society Armenia Chapter]]
* '''IGF Meetings''': IGF {Year}
:''Example'': [[IGF 2007]]
* '''Acronyms''':
** '''Rule''': The article's full name is the root page, while its acronym should redirect to the root.
** '''Exceptions''': Organizations and events that are almost unanimously known by their acronym, as is the case of [[RALO]]s, [[NIC]]s, and the IGF.
::''Example for rule'': [[Registration Data Access Protocol]] is the root and [[RDAP]] is the redirect.
::''Example for exception'': [[IGF]] is the root and [[Internet Governance Forum]] is the redirect.
 
==Data sources==
===Trusted sources===
* [https://arstechnica.com/ Ars Technica]
* [https://restofworld.org/ Rest of World]
* [https://ourworldindata.org/internet Our World in Data]
===Useful sources===
* [https://circleid.com/ CircleID]
* [https://www.icann.org/history ICANN History Project]
* [https://www.icann.org/opendata ICANN Open Data Initiative]
* [https://learn.icann.org/ ICANN Learn]
* [https://github.com/datactive/bigbang BigBang]
* [https://historyofcomputercommunications.info/ The History of Computer Communications]
* [https://www.youtube.com/user/ComputerHistory Computer History Museum]
* [https://elists.isoc.org/mailman/listinfo/internet-history Internet History mailing list]
* [https://www.platformgovernancearchive.org/ Platform Governance Archive]
* '''Podcasts''':
** [https://www.powerplays.xyz/index.html Power Plays]
** [https://www.internethistorypodcast.com/ Internet History Podcast]
** [https://www.csis.org/podcasts/does-not-compute This Does Not Compute]
** [https://darknetdiaries.com/ Darknet Diaries]
** [https://www.kaspersky.com/blog/kaspersky-transatlantic-podcast/ Kaspersky Transatlantic Podcast]
 
==Templates==
The contents of the templates below are presented for reference only and may not reflect their live version due to these not being directly extracted from the current source of the templates.
 
===Template:Articles needing attention===
<div class="icannwiki-warning">
<div>'''This {{#if:{{{section|}}}|section|article}} needs attention.''' Please help '''improve it''' by revising it in a manner consistent with ICANNWiki's [[Meta:ICANNWiki_Content_Planning|content guidelines]]. Pay attention to matters such as maintaining a neutral point of view and sourcing information where possible.</div>
</div>
 
===Template:Candidates for deletion===
<div class="icannwiki-danger">
<div>'''This {{#if:{{{section|}}}|section|article}} has been marked for deletion''', most likely due to not following ICANNWiki's [[Meta:ICANNWiki_Content_Planning|content guidelines]]. Without undergoing '''substantial changes''', it will eventually be '''removed''' by our content managers.</div>
</div>
 
===Template:Major articles parallel with Wikipedia===
<div class="icannwiki-signal">
<div>'''This {{#if:{{{section|}}}|section|article}} concerns a major concept that exist in the English version of Wikipedia''', which can be seen by [https://en.wikipedia.org/wiki/{{PAGENAMEE}} clicking here]. However, it has been deemed appropriate by our content managers to have its own unique and unrelated version in ICANNWiki.</div>
</div>


==ICANNWiki feature documentation==
==ICANNWiki feature documentation==
Line 82: Line 13:
*'''Audio embedding'''
*'''Audio embedding'''
** Built-in via MediaWiki.
** Built-in via MediaWiki.
** Usage: <nowiki>[[File:Filename.extension|Caption]]</nowiki> ('''''Incomplete?''''')
** 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.
** Example: <nowiki>[[File:Test.mp3|Test]]</nowiki> embeds a media player for the file.
* '''Timelines'''
** Provided via [https://www.mediawiki.org/wiki/Extension:EasyTimeline Extension:EasyTimeline].
** Usage: See [https://www.mediawiki.org/wiki/Extension:EasyTimeline/syntax documentation].
** Example: [[ICANN Historical Timeline]]


* '''Mathematics'''
* '''Mathematics'''
** Provided via [https://www.mediawiki.org/wiki/Extension:Math Extension:Math]
** Provided via [https://www.mediawiki.org/wiki/Extension:Math Extension:Math]
** Usage: Unknown
** Usage: <nowiki><math>LaTeX-formatted math expression</math></nowiki>
** Example: Unknown
** Example: <nowiki><math>\frac{1}{2}/math></nowiki> results in <math>\frac{1}{2}</math>.
 
* '''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>
 
* '''Show a template without invoking its categories'''
** Provided via [https://www.mediawiki.org/wiki/Extension:Scribunto Extension:Scribunto]
** Usage: <nowiki>{{#invoke:ShowTemplateContent|showTemplate|TEMPLATE NAME}}</nowiki>
** Example: <nowiki>{{#invoke:ShowTemplateContent|showTemplate|Template:Articles needing attention}}</nowiki>


* '''External data'''
* '''External data'''
** Provided via [https://www.mediawiki.org/wiki/Extension:External_Data Extension: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].
** Usage: See [https://www.mediawiki.org/wiki/Extension:External_Data documentation].
** Example: Unknown
** 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>


* '''PDF'''
* '''Lowercase title'''
** Provided via [https://www.mediawiki.org/wiki/Extension:PdfHandler Extension:PdfHandler]
** Makes use of [[Template:LowercaseTitle]].
** Usage: Unknown
** 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.
** Example: Unknown
** Usage: <nowiki>{{LowercaseTitle}}</nowiki>
 
* '''Simple external linking'''
** Makes use of [[Special:Interwiki]].
** Shortcuts to relevant projects: doi, rfc, wikibooks, wikicities, wikinfo, wikipedia, wikiquote, wikisource, wiktionary.
 
* '''Semi-automated wiki maintenance'''
** Usage: These self-updating categories point to varied errors in the wiki that need fixing.
** [[:Category:Pages with broken file links]]
** [[:Category:Pages using duplicate arguments in template calls]]
** [[:Category:Pages with reference errors]]


===SysOps and devs===
===SysOps and devs===
* '''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: <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.
* Edit sidebar: [[MediaWiki:Sidebar]]
* Edit sidebar: [[MediaWiki:Sidebar]]
* Welcome messages are dictated by: [[MediaWiki:Confirmaccount-welc]]
* Captchas are managed and can have their difficulty lowered or increased by: [https://www.mediawiki.org/wiki/Extension:ConfirmEdit]
* [[Special:CheckUser]]: Insights into technical information of users.
* [[Special:CheckUser]]: Insights into technical information of users.
* [[Special:Nuke]]: Mass deletion of articles tool, for recent changes only.
* [[Special:Nuke]]: Mass deletion of articles tool, for recent changes only.
* [[Special:ReplaceText]]: Mass text replacement across multiple articles.
* [[Special:ReplaceText]]: Mass text replacement across multiple articles.
* [[Special:BatchUpload]]: Batch file uploading via [https://www.mediawiki.org/wiki/Extension:SimpleBatchUpload Extension:SimpleBatchUpload].
* [[Special:BatchUpload]]: Batch file uploading via [https://www.mediawiki.org/wiki/Extension:SimpleBatchUpload Extension:SimpleBatchUpload].
* [https://www.mediawiki.org/wiki/Extension:SpamBlacklist Extension:SpamBlacklist]: [[MediaWiki:Spam-blacklist]], [[MediaWiki:Spam-whitelist]], [[MediaWiki:Email-blacklist]], [[MediaWiki:Email-whitelist]]
* [https://www.mediawiki.org/wiki/Extension:Approved_Revs Extension:Approved Revs]: Sets an "approved revision" of an article that will display by default to readers instead of the current revision.
* [https://www.mediawiki.org/wiki/Extension:Approved_Revs Extension:Approved Revs]: Sets an "approved revision" of an article that will display by default to readers instead of the current revision.
* [https://www.mediawiki.org/wiki/Extension:PageNotice Extension:PageNotice] Places a note in every article within a namespace.
* [https://www.mediawiki.org/wiki/Extension:SpamBlacklist Extension:SpamBlacklist]: manual white or black list for URLs and email addresses at: [[MediaWiki:Spam-blacklist]], [[MediaWiki:Spam-whitelist]], [[MediaWiki:Email-blacklist]], [[MediaWiki:Email-whitelist]]
* [[Special:Interwiki]] (dev only): Internal shortcuts for other wiki projects.
* [[Special:AbuseFilter]]: set specific reactions to actions by users, such as edits, match certain criteria. [https://www.mediawiki.org/wiki/Extension:AbuseFilter]
 
====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
 
==List of Lua modules==
Automated list:
{{Special:AllPages/Module:}}


==Wiki resources==
==Wiki resources==
===ICANNWiki presence elsewhere===
* [https://en.wikipedia.org/wiki/ICANNWiki ICANNWiki on Wikipedia]
===Wikimedia===
===Wikimedia===
* [https://en.wikipedia.org/wiki/Help:Wikitext Help:Wikitext]: Formatting reference.
* [https://en.wikipedia.org/wiki/Help:Wikitext Help:Wikitext]: Formatting reference
 
===Magic words===
* [https://en.wikipedia.org/wiki/Help:Magic_words Help:Magic words]: Magic words list
* <nowiki>{{NAMESPACENUMBER}}</nowiki>
* <nowiki>{{NUMBEROFARTICLES}}</nowiki>


===Pages===
===Pages===
Line 143: Line 124:
* [[Special:Version]]
* [[Special:Version]]


<div class="icannwiki-section-header">'''Meta'''</div>
[[Category:ICANNWiki]]
<div class="icannwiki-justified icannwiki-colored-box">
{{Template:MetaResources}}
</div>

Latest revision as of 18:50, 14 February 2025

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.

Content Guide for ICANNWiki

Please refer to ICANNWiki:Content Guide.

ICANNWiki feature documentation

All users

  • Video embedding
    • Provided via Extension:EmbedVideo.
    • Usage: {{#ev:service|id|dimensions|alignment|description|container|urlargs|autoresize|valignment}}
    • Example: {{#ev:youtube|mQr3zTKvnyE}} embeds a Youtube video of ICANN 40's opening press conference.
  • Audio embedding
    • Built-in via MediaWiki.
    • Usage: [[File:Name.extension|thumb/frameless|left/center/right|autostart=yes/no|loop=yes/no|start=number|end=number|Caption]]
    • Example: [[File:Test.mp3|Test]] embeds a media player for the file.
  • Mathematics
    • Provided via Extension:Math
    • Usage: <math>LaTeX-formatted math expression</math>
    • Example: <math>\frac{1}{2}/math> results in 12.
  • PDF
    • Provided via Extension:PdfHandler
    • Usage: PdfHandler display a PDF file like an image, generating thumbnails of its pages.
    • Example: [[File:Name.pdf|thumb|page=number|0px|Caption]]
  • Show a template without invoking its categories
    • Provided via Extension:Scribunto
    • Usage: {{#invoke:ShowTemplateContent|showTemplate|TEMPLATE NAME}}
    • Example: {{#invoke:ShowTemplateContent|showTemplate|Template:Articles needing attention}}
  • External data
    • Provided via Extension:External Data
    • Usage: See documentation.
    • Example: {{#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}}
  • 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: {{LowercaseTitle}}
  • Simple external linking
    • Makes use of Special:Interwiki.
    • Shortcuts to relevant projects: doi, rfc, wikibooks, wikicities, wikinfo, wikipedia, wikiquote, wikisource, wiktionary.

SysOps and devs

Page Notice

  • Provided via 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):

List of Lua modules

Automated list:

Wiki resources

ICANNWiki presence elsewhere

Wikimedia

Magic words

Pages

Categories

Users

Technical

Retrieved from "https://icannwiki.org/index.php?title=ICANNWiki:Documentation&oldid=1359151"