Help:Editing primer: Difference between revisions

From Endurance Coalition
Jump to navigation Jump to search
No edit summary
No edit summary
 
(3 intermediate revisions by the same user not shown)
Line 1: Line 1:
This page will go over information on how to preform functions necessary for editing that aren't just editing exiting content. See [[Help:Handout]] for important information that all editors need to understand.
This page will go over information on how to preform functions necessary for editing that aren't just messing with existing content. See [[Help:Handout]] for important information that all people with accounts need to understand.


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]].


== Creating pages ==
== 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 editor the page does not yet exist and ask if they wish to create it. The editor will then 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.
Use the search bar and pretend to search for the page you want to eventually exist (spelling and case matter). A new page will appear telling you the page does not yet exist and ask if you wish to create it. 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 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".
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 is called '''''moving''''' on wikis. This is because the edit history and meta data have to be '''''moved''''' to the new page name as well as just it's content. This is accomplished by hovering your mouse over the button that says "More" and selecting "Move".


=== Redirects and page name importance ===
=== Redirects and page name importance ===
Something to keep in mind when moving a page 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 viewer 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]].
Any links on the wiki which point to a moved page 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 <code>Leave a redirect behind</code> is ticked. This makes [[Gummybears]] automatically send a viewer that goes to it to [[Gummy bears|Gummy bears.]] This is the acceptable means of handling the 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 an administrator or seasoned contributor before moving pages.
Non-regular editors of the wiki are encouraged to seek guidance from an administrator or seasoned contributor before moving pages.


== Protected pages and files ==
== Protected pages and files ==
Very rarely, an [[Special:Listusers/sysop|'''administrator''']] will determine that some kind of page on this website requires that only an administrator edit it. An editor will know if a page is protected and they lack permissions by seeing the button "View source" rather than "Edit" or "Edit source". Bigger wikis use this on high-traction pages to avoid misinformation and to maintain a stable version. For this wiki, it's usually pages relating to policy, files which are official or widely used where changing them is unlikely to make sense, and templates that if not edited carefully can result in a negative cascade effect that makes the website unreadable. While such issues are easy to resolve, they may be hard to catch given the low-traction nature of the wiki, and so it's determined that prevention is the superior option.
Very rarely, an '''[[Help:Permissions#Administrator|administrator]]''' will determine that a page or file should only be edited by administrators. This is indicated by editors seeing a <code>View source</code> button rather than <code>Edit</code> or <code>Edit source</code>. These are usually pages relating to policy, files which are official, files that are widely used where changing them is unlikely to make sense, or templates that if broken can result in a negative cascade effect that effects the wiki writ large.  


If there is a page that an editor wishes to manipulate, but cannot, they are to contact an administrator for assistance. Editors can also ask to ''become'' an administrator (see the relevant card at [[Help:Handout]]) if this becomes a frequent problem.
If there is a page that an editor wishes to edit, but cannot, they are to contact an administrator for assistance. Editors can also ask to ''become'' an administrator (see [[Help:Permissions]]).


== Categories ==
== 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.
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 at least one category, and it should be the most specific category available. Editors unsure of where to place a page should put the page in [[:Category:Categories]] and then post somewhere in Discord that they did so. This way, a more seasoned contributor can give the appropriate category later.


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.
Categories are added in the Visual Editor by clicking the [[wikipedia:Help:VisualEditor#Editing categories|3 horizontal bars]] to the left of the <code>Save changes...</code> button and selecting <code>Categories</code>. 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.


== Using images ==
== Using images ==
Any image that an editor wishes to use must be manually uploaded to the wiki. This is done by going to [[Special:Upload]].  
Any image that an editor wishes to use must be manually uploaded to the wiki. This is done by going to [[Special:Upload]].  


Notice how there is a '''big box''' of information at the top of [[Special:Upload]] that says "'''Important File Uploading Guidelines'''". This should be read in it's entirety. In short, when you upload a file, you must select a license that most appropriately fits the file. This way this wiki knows the copyright rationale of any given file if a copyright holder reaches out to complain about the file being hosted here. You must also, if you aren't the sole creator of the file, provide a link to where you got the file and who owns the copyright of the file in the "Summary" box.
Notice how there is a '''big box''' of information at the top of [[Special:Upload]] that says "'''Important File Uploading Guidelines'''". This should be read in it's entirety.


Once an image is fully uploaded, it can be added to a page in the VisualEditor by clicking "Insert" on the toolbar followed by "Images and media" then locating the relevant file. For information on how to do this in markdown, see [[mw:Help:Images|Help:Images]].
Once an image is uploaded, it can be added to a page in the VisualEditor by clicking <code>Insert</code> on the toolbar followed by <code>Images and media</code> then locating the relevant file. For information on how to do this in markdown, see [[mw:Help:Images|Help:Images]].


== Minor edits ==
=== InstantCommons ===
You may notice there is a checkbox that says "This is a minor edit" when editing. The intent of this feature is to allow those that review page history to differentiate between edits which are negligible, such as fixing spelling, punctuation, or grammar, from edits which actually add, remove, or edit content. This is marginally useful on larger wikis, but for the purposes of ''this'' wiki, it is '''irrelevant'''.  
Editors will quickly see that, if adding images using the VisualEditor, that there are a ''lot'' of images they can add to a page that aren't actually hosted on this wiki (i.e not at [[Special:ListFiles]]). This is because this wiki has opted into [[mw:InstantCommons|InstantCommons]]. This is a feature that allows the native use of any image uploaded to [[commons:Main Page|Wikimedia Commons]], a project that hosts files that exclusively have free licenses, as if it were on the wiki locally. Any image available from this service may be used freely.
 
It is ultimately immaterial if an editor uses it or not.


== Edit summaries ==
== Edit summaries ==
An edit summary is a box available near the "Save changes" button that gives editors an opportunity to describe briefly what their edit is doing. This makes it simpler to review page history and see how a page changes over time. This is '''''strongly desired'''''. While this is not enforced strictly, if problems begin to arise out of an editor making strings of edits without summaries making them difficult to review, administrators may contact the editor and mandate their use.
An edit summary is a box available near the <code>Save changes</code> button that gives editors the ability to describe what their edit has done. This makes it simpler to review page history and see how a page changes over time. This is '''''strongly desired''''', but not required.


[[Category:Meta pages]]
[[Category:Meta pages]]

Latest revision as of 02:25, 7 June 2025

This page will go over information on how to preform functions necessary for editing that aren't just messing with existing content. See Help:Handout for important information that all people with accounts need to understand.

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

Creating pages

Use the search bar and pretend to search for the page you want to eventually exist (spelling and case matter). A new page will appear telling you the page does not yet exist and ask if you wish to create it. 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 is called moving on wikis. This is because the edit history and meta data have to be moved to the new page name as well as just it's content. This is accomplished by hovering your mouse over the button that says "More" and selecting "Move".

Redirects and page name importance

Any links on the wiki which point to a moved page 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 makes Gummybears automatically send a viewer that goes to it to Gummy bears. This is the acceptable means of handling the 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 wiki are encouraged to seek guidance from an administrator or seasoned contributor before moving pages.

Protected pages and files

Very rarely, an administrator will determine that a page or file should only be edited by administrators. This is indicated by editors seeing a View source button rather than Edit or Edit source. These are usually pages relating to policy, files which are official, files that are widely used where changing them is unlikely to make sense, or templates that if broken can result in a negative cascade effect that effects the wiki writ large.

If there is a page that an editor wishes to edit, but cannot, they are to contact an administrator for assistance. Editors can also ask to become an administrator (see Help:Permissions).

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 at least one category, and it should be the most specific category available. Editors unsure of where to place a page should put the page in Category:Categories and then post somewhere in Discord that they did so. This way, a more seasoned contributor can give the appropriate category later.

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.

Using images

Any image that an editor wishes to use must be manually uploaded to the wiki. This is done by going to Special:Upload.

Notice how there is a big box of information at the top of Special:Upload that says "Important File Uploading Guidelines". This should be read in it's entirety.

Once an image is uploaded, it can be added to a page in the VisualEditor by clicking Insert on the toolbar followed by Images and media then locating the relevant file. For information on how to do this in markdown, see Help:Images.

InstantCommons

Editors will quickly see that, if adding images using the VisualEditor, that there are a lot of images they can add to a page that aren't actually hosted on this wiki (i.e not at Special:ListFiles). This is because this wiki has opted into InstantCommons. This is a feature that allows the native use of any image uploaded to Wikimedia Commons, a project that hosts files that exclusively have free licenses, as if it were on the wiki locally. Any image available from this service may be used freely.

Edit summaries

An edit summary is a box available near the Save changes button that gives editors the ability to describe what their edit has done. This makes it simpler to review page history and see how a page changes over time. This is strongly desired, but not required.