View source for Help:Editing

== Editing articles ==
{{see also|Information:FAQ/Editing}}
=== Content style and policies ===
{{see also|BTW:CONPOL}}
An [[BattleTechWiki:Writing better articles#Information style and tone|encyclopedic style]] with a [[BattleTechWiki:Writing better articles#Tone|formal tone]] is important: straightforward, [[BattleTechWiki:Summary style|just-the-facts]], instead of essay-like, argumentative, or opinionated. The goal of a BattleTechWiki article is to create a comprehensive and [[BattleTechWiki:Neutral point of view|neutrally written]] summary of existing canon knowledge about a topic. BattleTechWiki does attempts to not publish [[BattleTechWiki:No original research|original research]], unless it needs too. An encyclopedia is, by its nature, a [[w:tertiary source|tertiary source]] that provides a survey of information already published in the wider world. Ideally, all information should be [[BattleTechWiki:Citing sources|cited]] and [[BattleTechWiki:Verifiability|verifiable]] by [[BattleTechWiki:Reliable sources|reliable sources]]. Sourcing requirements are significantly stricter in [[BattleTechWiki:Real People|articles on real persons]].
{{anchor|Edit window}}
=== Edit screen(s) ===
Editing most BattleTechWiki pages is simple. BattleTechWiki at the moment uses only one (of two) interface methods: classic editing with the [[Help:SourceEditor|SourceEditor]] through [[Help:Wikitext|wikitext]] (wiki markup).

Wikitext editing using the Source Editor is chosen by clicking the <kbd>Edit source</kbd> tab at the top of a BattleTechWiki page (or on a [[Help:Section|section-edit link]]). This opens an editable copy of the page, showing all the wikitext used there, and the Source Editor toolbar offers simple menu options to add or change the formatting. Wikitext is used extensively throughout BattleTechWiki for such things as [[Help:Link|hyperlinks]], [[Help:Table|tables]] and [[Help:Columns|columns]], [[Help:Footnotes|footnotes]], [[BattleTechWiki:Inline citation|inline citation]], [[Help:Special characters|special characters]] and so on. The Source Editor lets users toggle on 'wikitext highlighting' which uses different colours to help differentiate article text from wikitext.

[[File:How to edit a page Edit box.png|center|600px|How to edit a page Edit box]]


The BattleTechWiki community has developed [[BattleTechWiki:Manual of Style|style guidelines]] to make articles and facts appear in a standardized form, and BattleTechWiki easier to use as a whole. A basic list of [[Help:Wikitext|wikitext]] can be found on the [[Help:Cheatsheet|cheatsheet]]. An "[[Help:Edit toolbar|edit toolbar]]" is provided just above the edit box (pictured below), which allows logged-in users (by selecting the option in [[Special:Preferences#mw-prefsection-gadgets|personal preferences]]) to automatically place and format various aspects of wiki code. See [[Help:Wikitext]] for more information, remember that you can't break BattleTechWiki, and, although there are many protocols, [[BattleTechWiki:Editing policy#BattleTechWiki is a work in progress: perfection is not required|perfection is not required]].

[[File:WikiEditor-advanced menu-en.png|center]]

When you have finished editing, you should write a short [[Help:Edit summary|edit summary]] in the small field below the edit box (pictured below). You may use shorthand to describe your changes. To see how the page looks with your edits, press the "'''Show preview'''" button. To see the differences between the page with your edits and the previous version of the page, press the "'''Show changes'''" button. If you're satisfied with what you see, '''[[BattleTechWiki:Be bold|be bold]]''' and press the "'''Publish changes'''" button. Your changes will immediately be visible to all BattleTechWiki users.
{{EditOptions|align=center|width=50em|font-size=80%}}
Note: Do not sign the edit summary line with your <nowiki>~~~~</nowiki> signature, as it does not work there.

==== Minor edits ====
{{further|Help:Minor edit}}
[[File:Minor edit.png|thumb|upright|The "minor edit" checkbox (circled) in the wikitext editor]]
A check to the "minor edit" box signifies that only superficial differences exist between the version with your edit and the previous version: typo/grammar corrections, fixing a formatting problem, etc. A ''minor edit'' is a version that the editor believes requires no review and could never be the subject of a dispute. Marking a change as minor does not mean that the edit is unimportant.

The "minor edit" option is one of several [[BattleTechWiki:Why create an account?#New editing options|options]] available only to [[Help:Logging in|registered users]]. Editors are never required to use this button. When in doubt, consider your work to be a normal edit.

==== Major edits ====
{{further|BattleTechWiki:Editing policy#Talking and editing}}
All editors are encouraged to [[BattleTechWiki:Be bold|be bold]] when improving articles, but there are several things that a user can do to ensure that potentially disruptive edits are performed smoothly. Before engaging in a major edit, a user should consider discussing proposed changes on the article discussion/talk page. During the edit, if doing so over an extended period, the {{tlx|in use}} tag can reduce the likelihood of an [[Help:Edit conflict|edit conflict]]. Once the edit has been completed, the inclusion of an [[Help:Edit summary|edit summary]] will assist in documenting the changes. These steps will help all to ensure that major edits are well received by the BattleTechWiki community.

A major edit should be reviewed to confirm that it is consensual to all concerned editors. Therefore, any change that affects the ''meaning'' of an article is major (not minor), even if the edit is a single word.

There are no necessary terms to which you have to agree when doing major edits, but the preceding recommendations have become best practice. If you do it your own way, the likelihood of your edits being re-edited may be higher.

When making particularly large or complex changes, you may want to copy the article to [[Special:MyPage/sandbox|your sandbox]], so you can make changes without being interrupted by other editors. It is also a good idea to publish changes frequently, so that a browser crash or electrical failure will not result in you losing all of your work.

=== Adding references ===
{{further|Help:Referencing for beginners|BattleTechWiki:Citing sources}}
Generally, sources are added directly after the facts they support at the end of the sentence and after any punctuation. BattleTechWiki permits editors to use any citation system that allows the reader to understand where the information came from and strongly encourages the use of [[BattleTechWiki:Inline citation|inline citations]] to do so. Common methods of placing inline citations include [[Help:Footnotes|footnotes]], [[Help:Shortened footnotes|shortened footnotes]] and [[BattleTechWiki:Citing sources#Parenthetical referencing|parenthetical references]].

Inline citations are most commonly placed by inserting a reference between <code><nowiki><ref></nowiki></code> ... <code><nowiki></ref></nowiki></code> tags, directly in the text of an article. The reference is a footnote, appearing as an inline link (e.g. <small><sup><span style="color:#002BB8">[1][2]</span></sup></small>) to a particular item in a collated, numbered list of footnotes, found wherever a {{tl|reflist}} template or <code><nowiki><references /></nowiki></code> tag is present, usually in a section titled "References" or "Notes". If you are creating a new page or adding references to a page that didn't previously have any, don't forget to add a references section with this display markup.

=== Adding images, sounds, and videos ===
{{main|Help:Uploading images}}
A file that is already hosted on BattleTechWiki or the [[w:Wikimedia Commons|Wikimedia Commons]] can be inserted with the basic code <code><nowiki>[[File:FILENAME|thumb|DESCRIPTION]]</nowiki></code>. (<code>Image:</code> can be substituted for <code>File:</code> with no change in effect; the choice between the two is purely a matter of editorial preference.) Using <code>thumb</code> generates a [[w:thumbnail|thumbnail]] of an image (the most common placement option), which is typically sized differently from the original image. The Wikimedia Commons' [[Commons:Special:UploadWizard|File Upload Wizard]] and BattleTechWiki's [[Special:Upload|Basic File Upload]] will guide you through the process of submitting media. There are various file formats available.