Help:Editing primer: Difference between revisions

From Endurance Coalition
Jump to navigation Jump to search
refactor
rewrite
Line 1: Line 1:
{{Meta page}}
This guide is aimed at people who are completely unfamiliar with editing on MediaWiki sites but ''are'' familiar with traditional editing systems like WordPress, any sort of word document, and so on. This guide will hit on the items that are most likely to cause confusion. Hopefully, anyway.
 
This guide is aimed at people who are completely unfamiliar with editing on MediaWiki sites (if they even know what that means), but are familiar with traditional editing systems like WordPress, any sort of word document, and so on. This should hopefully knock out a lot of quick vital differences between the 2 systems to allow an easier learning curve.


For information on how the markdown of MediaWiki pages work, see [[mw:Help:Formatting|Help:Formatting]].
For information on how the markdown of MediaWiki pages work, see [[mw:Help:Formatting|Help:Formatting]].
Line 8: Line 6:
So that we share the same language, please commit the following terms to memory.
So that we share the same language, please commit the following terms to memory.
{| class="wikitable"
{| class="wikitable"
!Term
!Definition
|-
|-
! Term !! Definition
|'''Wiki'''
|A website that has a system in place to allow collaborative editing rather than a central authority dictating content, such as a blog. Think the [https://zeldawiki.wiki/wiki/Main_Page Zelda Wiki], or [https://www.fandom.com/ Fandom] itself.
|-
|-
| '''Wiki''' || A website that has a system in place to allow collaborative editing rather than a central authority dictating content, such as a blog. Think the [https://zeldawiki.wiki/wiki/Main_Page Zelda Wiki], or [https://www.fandom.com/ Fandom] itself.
|[[wikipedia:Main Page|'''Wikipedia''']]
|More properly known as the ''English'' Wikipedia, it is the online encyclopedia that everyone can edit that everyone knows of.<ref>Keep in mind that there are versions of Wikipedia in various languages, such as [https://es.wikipedia.org/wiki/Wikipedia:Portada Spanish] and [https://it.wikipedia.org/wiki/Pagina_principale Italian]. [[metawikimedia:Complete_list_of_Wikimedia_projects|Click me]] for a full list.</ref>
|-
|-
| [[wikipedia:Main Page|'''Wikipedia''']] || More properly known as the ''English'' Wikipedia, it is the online encyclopedia that everyone can edit that everyone knows of.<ref> Keep in mind that there are versions of Wikipedia in various languages, such as [https://es.wikipedia.org/wiki/Wikipedia:Portada Spanish] and [https://it.wikipedia.org/wiki/Pagina_principale Italian]. [https://meta.wikimedia.org/wiki/Complete_list_of_Wikimedia_projects Click me] for a full list.</ref>
|[https://wikimediafoundation.org/ '''Wikimedia''']
|-
|A non-profit foundation that performs the administration and systems upkeep of the various language editions of Wikipedia.
| [https://wikimediafoundation.org/ '''Wikimedia'''] || A non-profit foundation that performs the administration and systems upkeep of the various language editions of Wikipedia.
|-
| [[mw:MediaWiki|'''MediaWiki''']] || A [[wikipedia:Free and open-source software|'''free and open source''']] software that is designed to provide a wiki-style of editing to a website. This software is what runs this very website and the English Wikipedia.
|-
|-
|[[mediawikiwiki:MediaWiki|'''MediaWiki''']]
|A [[wikipedia:Free and open-source software|'''free and open source''']] software that is designed to provide a wiki-style of editing to a website. This software is what runs this very website and the English Wikipedia.
|}
|}
== Creating pages ==
Creating pages is simple, yet unintuitive. One simply uses the search bar at the top right of any page and makes a search for the page (spelling and character-case matter) they would like to exist. A new page will appear telling the user the page does not yet exist and ask if they wish to create it. The user will click the red text that is the new page name, and then edit normally. Once the first edit to the page is published the page goes live.


== Renaming pages ==
== Renaming pages ==
Unlike traditional word processing software, MediaWiki is unique in that '''every edit''' is logged, along with '''the information on who did it and when''', and '''every version of a page''' after '''every version of an edit''' is ''also'' logged. While this is impressive, and makes the website incredibly resilient as any problematic edit can be reversed with a button click, the downside is that renaming pages is more complicated. To MediaWiki, page names are not cosmetic, they are crucial database identifiers. Thus, to rename a page, in MediaWiki's language, you '''''move''''' the page to '''a new page name'''. This specific process results in all of the metadata, edits, and page history being ''moved'' to it's new name.
Unlike traditional word processing systems, such as Google Docs, MediaWiki uses the title of a page as it's internal database identifier. Page names are not cosmetic. The changing of a page's name in any way is called, in MediaWiki terminology, '''''moving''''' the page. This is because the edit history and meta data have to be '''''moved''''' to the new page name as well. This is accomplished by hovering your mouse over the button that says "More" and selecting "Move".


Due to the setup of the wiki, it is ill advised to move pages unless you are a regular contributor with an intimate understanding of the wiki's construction. Otherwise, please consult Sirdog (<code>sirdog3355</code>) or a known seasoned contributor, that way the navigation of information is not disrupted. To provide perspective, were the page [[Bogatyr]] renamed to, say, [[BogaTyr]], all links that lead to [[Bogatyr]] would break. As of November 1, there are '''7''' different pages linking to it. That is a lot of tedious work. This risk is doubled for [[mw:Help:Templates|templates]]. Were [[Template:ActionTemplate]] to be moved, '''50''' pages would be impacted, and the information on company pages would be completely unreadable.
=== Redirects and page name importance ===
Something to keep in mind when changing a page's name is that any links on the wiki which point to it will, by default, break. So if a page titled [[Gummybears]] is moved to [[Gummy bears]] any page with a link to [[Gummybears]] will lead to a now non-existent page. This issue is mitigated by, when using the move tool, ensuring the checkbox for "Leave a redirect behind" is ticked. This then makes [[Gummybears]] automatically redirect a user that goes to it to [[Gummy bears|Gummy bears.]] This is generally the acceptable means of handling this issue in 99% of cases. If a situation comes up where this is ''not'' desirable, then every page that links to [[Gummybears]] will need to be manually edited to lead to [[Gummy bears]].


This risk is mitigated by [[mw:Help:Redirects|redirects]], but that's entering a "not-getting started guide" level of detail.
Non-regular editors of the war game wiki are encouraged to seek guidance from a wiki administrator or seasoned contributor before moving pages.


== Accidental publication of sensitive information ==
== Warning on edit publication ==
{{Ambox
{{Ambox|type=speedy|image=|text=This section is '''very''' important.}}
| type     = speedy
Every edit, the content of the edit, who made the edit, and when the edit was made is publicly logged. Every version of a page after every edit is similarly logged. This makes this website incredibly resilient to breakage, but also means that it's difficult to truly delete information. Simply editing the information out and clicking "Save changes" is insufficient. Anyone with an internet connection can check the page's history and still find the information.
| image     =  
| text     = This section is '''very''' important.
}}


It is possible that, at some point, content is fully published to a page that should not be public. This may be a link to a Google form or spreadsheet ([[Template:AbuseFilterGoogle|and you somehow missed the warning designed specifically to mitigate this risk]]), you accidentally copy-and-paste your password in a change you made, or your little brother decides it's funny to add your phone number to an edit while you weren't looking.
If an edit is published to a page with information that the user does not want to be publicly accessible, then the information should still be edited out, but then a wiki administrator must be notified so they can delete the edit from the public archives. '''This notification should be done privately to avoid the [[wikipedia:Streisand effect|Streisand effect]]'''. For details on how they do this, check out [[mediawikiwiki:Help:RevisionDelete|Help:RevisionDelete]].


Regardless, '''it is <u>not sufficient</u> to simply edit the undesirable information out'''. This is because, as detailed in the previous section, every version of a page after an edit is logged. These logs are visible to the entire internet since this website is publicly accessible. For example, [[Special:PermaLink/13|'''this edit''']] is how the front page looked on October 16, 2024.
Certain automated filters are in place that will either block an edit entirely, or warn a user, when particular public information that is likely inappropriate to add has been introduced into an edit. Editors are encouraged to take such warnings seriously.
 
As a result, if the above happens, you '''should still remove it by editing it out''', but then you must alert a site administrator (Sirdog is a safe bet) '''''immediately''''' so they may delete the edit from public visibility. [https://endurance.sirdog.net/index.php?title=Special:Log&logid=412 '''This is an example'''] of when such information has been properly deleted. For details on how this is done mechanically, check out [[mw:Help:RevisionDelete|Help:RevisionDelete]].


== Categories ==
== Categories ==
'''All''' pages should receive a category; a special kind of page that easily groups pages together for ease of navigation and classification. A list of all categories the website holds is available at [[:Category:Categories]]. If making a new page, please place it in the ''most specific'' category. For example, if creating a template for a war game action, place it in [[:Category:Actions]] rather than [[:Category:Game mechanics]].


If completely unsure, at ''least'' place it in [[:Category:Categories]] and alert known wiki editors so they may better categorize it.
A category is a special kind of page that easily groups pages together for navigation and classification purposes. A list of all categories is available at [[:Category:Categories]]. Any new page added should be given a minimum of one category, and it should be the most specific category available. Editors unsure of where to place a page should at a minimum place the page into [[:Category:Categories]] and then post in some public place they did so, that way a more seasoned contributor can more appropriately classify it.


Adding a category is done by clicking the [[wikipedia:Help:VisualEditor#Editing categories|three horizontal bars button next to the pencil in Visual Editing mode]]. In markdown mode, add the text <code><nowiki>[[Category:<category-name>]]</nowiki></code> anywhere on the page. For stylistic reasons, it should be at the very bottom.
Categories are added in the Visual Editor by clicking the [[wikipedia:Help:VisualEditor#Editing categories|3 horizontal bars]] to the left of the "Save changes..." button and selecting "Categories". In markdown mode, add the text <code><nowiki>[[Category:<category-name>]]</nowiki></code> anywhere on the page. For stylistic reasons, it should be at the very bottom.
 
== Page protection ==
You may notice that certain pages on this website cannot be edited. Instead of seeing <code>Edit</code> or <code>Edit source</code>, you may see <code>View source</code>. An example would be [[:File:EDCLogo.png]]. This means a page has been protected by a site administrator from editing. Very few pages are given this treatment, since editing is already by it's nature selective, given user accounts must be requested manually.
 
This is typically reserved for templates or other kinds of pages that could cause things on the website to break or appear broken. While these errors are not always hard to correct, it may cause panic or confusion among readers and newer editors.
 
Regardless, if you find such a page and need it to have some kind of edit done, notify a [[Special:ListUsers/sysop|site administrator]].


== Permissions ==
== Permissions ==
While few in number, there are a couple of permissions that are not given to all users:
While few in number, there are a couple of permissions that are not given to all users:
* '''Administrator''' — Numerous additional functions for easy site administration. Most notably include blocking users, protecting pages, and deleting pages and logs from public visibility.
* '''Administrator''' — Numerous additional functions for easy site administration. Most notably include blocking users, protecting pages, and deleting pages and logs from public visibility.
* '''Bureaucrat''' — Can assign and revoke permissions, edit user accounts, and create new accounts.
* '''Bureaucrat''' — Can assign and revoke permissions, edit user accounts, and create new accounts.
Line 63: Line 56:
For an exhaustive list of all user permissions, and what each permission can explicitly do, see [[Special:ListGroupRights]].
For an exhaustive list of all user permissions, and what each permission can explicitly do, see [[Special:ListGroupRights]].


Any user with an account may request one of the above from Sirdog of whom may approve or deny such requests at his discretion. Those with prior history editing Wikimedia projects are considerably more likely to receive such permissions, though the biggest factor is level of editing activity, knowledge of wiki construction, and willingness to learn.  
Any user with an account may request one of the above from Sirdog of whom may approve or deny such requests at his discretion. Those with prior history editing Wikimedia projects are considerably more likely to receive such permissions, though the biggest factor is level of editing activity, knowledge of wiki construction, and willingness to learn.


Fleff, due to his nature as the gamemaster and curator of the game this wiki is dedicated too, is entitled to all above permissions at his request. He is also capable of vetoing any request for advanced permissions and ordering the disabling of any user's account. He is also, at his request, able to receive the Endurance War Game specific permission labeled "gamemaster" which allows the protection of pages from editing to even site administrators.
Fleff, due to his nature as the gamemaster and curator of the game this wiki is dedicated too, is entitled to all above permissions at his request. He is also capable of vetoing any request for advanced permissions and ordering the disabling of any user's account, along with directing that any advanced permissions an editor has being revoked.


== Footnotes ==
== Footnotes ==
{{Reflist}}
{{Reflist}}
[[Category:Meta]]

Revision as of 08:04, 30 January 2025

This guide is aimed at people who are completely unfamiliar with editing on MediaWiki sites but are familiar with traditional editing systems like WordPress, any sort of word document, and so on. This guide will hit on the items that are most likely to cause confusion. Hopefully, anyway.

For information on how the markdown of MediaWiki pages work, see Help:Formatting.

Terminology

So that we share the same language, please commit the following terms to memory.

Term Definition
Wiki A website that has a system in place to allow collaborative editing rather than a central authority dictating content, such as a blog. Think the Zelda Wiki, or Fandom itself.
Wikipedia More properly known as the English Wikipedia, it is the online encyclopedia that everyone can edit that everyone knows of.[1]
Wikimedia A non-profit foundation that performs the administration and systems upkeep of the various language editions of Wikipedia.
MediaWiki A free and open source software that is designed to provide a wiki-style of editing to a website. This software is what runs this very website and the English Wikipedia.

Creating pages

Creating pages is simple, yet unintuitive. One simply uses the search bar at the top right of any page and makes a search for the page (spelling and character-case matter) they would like to exist. A new page will appear telling the user the page does not yet exist and ask if they wish to create it. The user will click the red text that is the new page name, and then edit normally. Once the first edit to the page is published the page goes live.

Renaming pages

Unlike traditional word processing systems, such as Google Docs, MediaWiki uses the title of a page as it's internal database identifier. Page names are not cosmetic. The changing of a page's name in any way is called, in MediaWiki terminology, moving the page. This is because the edit history and meta data have to be moved to the new page name as well. This is accomplished by hovering your mouse over the button that says "More" and selecting "Move".

Redirects and page name importance

Something to keep in mind when changing a page's name is that any links on the wiki which point to it will, by default, break. So if a page titled Gummybears is moved to Gummy bears any page with a link to Gummybears will lead to a now non-existent page. This issue is mitigated by, when using the move tool, ensuring the checkbox for "Leave a redirect behind" is ticked. This then makes Gummybears automatically redirect a user that goes to it to Gummy bears. This is generally the acceptable means of handling this issue in 99% of cases. If a situation comes up where this is not desirable, then every page that links to Gummybears will need to be manually edited to lead to Gummy bears.

Non-regular editors of the war game wiki are encouraged to seek guidance from a wiki administrator or seasoned contributor before moving pages.

Warning on edit publication

Every edit, the content of the edit, who made the edit, and when the edit was made is publicly logged. Every version of a page after every edit is similarly logged. This makes this website incredibly resilient to breakage, but also means that it's difficult to truly delete information. Simply editing the information out and clicking "Save changes" is insufficient. Anyone with an internet connection can check the page's history and still find the information.

If an edit is published to a page with information that the user does not want to be publicly accessible, then the information should still be edited out, but then a wiki administrator must be notified so they can delete the edit from the public archives. This notification should be done privately to avoid the Streisand effect. For details on how they do this, check out Help:RevisionDelete.

Certain automated filters are in place that will either block an edit entirely, or warn a user, when particular public information that is likely inappropriate to add has been introduced into an edit. Editors are encouraged to take such warnings seriously.

Categories

A category is a special kind of page that easily groups pages together for navigation and classification purposes. A list of all categories is available at Category:Categories. Any new page added should be given a minimum of one category, and it should be the most specific category available. Editors unsure of where to place a page should at a minimum place the page into Category:Categories and then post in some public place they did so, that way a more seasoned contributor can more appropriately classify it.

Categories are added in the Visual Editor by clicking the 3 horizontal bars to the left of the "Save changes..." button and selecting "Categories". In markdown mode, add the text [[Category:<category-name>]] anywhere on the page. For stylistic reasons, it should be at the very bottom.

Permissions

While few in number, there are a couple of permissions that are not given to all users:

  • Administrator — Numerous additional functions for easy site administration. Most notably include blocking users, protecting pages, and deleting pages and logs from public visibility.
  • Bureaucrat — Can assign and revoke permissions, edit user accounts, and create new accounts.
  • Interface administrator — Can edit pages which dictate the look of the website (e.g MediaWiki:Editnotice-0-War game rules, which dictates the message shown to all editors that edit that page) and import pages from other MediaWiki instances to this wiki.

For an exhaustive list of all user permissions, and what each permission can explicitly do, see Special:ListGroupRights.

Any user with an account may request one of the above from Sirdog of whom may approve or deny such requests at his discretion. Those with prior history editing Wikimedia projects are considerably more likely to receive such permissions, though the biggest factor is level of editing activity, knowledge of wiki construction, and willingness to learn.

Fleff, due to his nature as the gamemaster and curator of the game this wiki is dedicated too, is entitled to all above permissions at his request. He is also capable of vetoing any request for advanced permissions and ordering the disabling of any user's account, along with directing that any advanced permissions an editor has being revoked.

Footnotes

  1. Keep in mind that there are versions of Wikipedia in various languages, such as Spanish and Italian. Click me for a full list.