Difference between revisions of "Editing"
Stratonian (talk | contribs) |
Stratonian (talk | contribs) |
||
Line 23: | Line 23: | ||
==Article Creation== | ==Article Creation== | ||
Before '''article creation''', ensure that it is necessary and relevant to Corepunk. Novice editors are reccommended to begin with smaller edits first before creating a new article. | Before '''article creation''', ensure that it is necessary and relevant to Corepunk. Novice editors are reccommended to begin with smaller edits first before creating a new article. | ||
− | |||
− | |||
==Talk Pages== | ==Talk Pages== | ||
− | '''Talk pages''' are used to discuss possible changes to a particular article before it becomes a submitted contribution. If an editor is unsure about a contribution, it is reccommended to ask in the article in question's related talk page. | + | '''Talk pages''' are used to discuss possible changes to a particular article before it becomes a submitted contribution. If an editor is unsure about a contribution, it is reccommended to ask in the article in question's related talk page.<br> |
+ | Editors should sign their contributions to a talk page with their [https://corepunk.wiki/w/Special:Preferences signature] with four tildes (i.e. "<nowiki>~~~~</nowiki>") | ||
+ | ==Documentation== | ||
+ | We strive for a wiki such that the average user can look at our source and understand its general function.<br> | ||
+ | In general, a page's source should be documented with comments if it is hard to read and/or understand. This means all code that isn't self-explanatory should be commented. | ||
+ | ===Naming Conventions=== | ||
+ | Pages and headings should be named formally, concisely and sensibly. It should convey a general idea of what the section is about. | ||
+ | ===Templates=== | ||
+ | {{Main|Help:Template Guidelines}} | ||
+ | Templates are snippets of wikitext to be included in articles. It is similar to a [https://en.wikipedia.org/wiki/Class_(computer_programming) class] in object-oriented programming.<br> | ||
+ | They are used by this wiki as a means of standardization and ease of use. In general, if a snippet is repeated across multiple pages, it should be abstracted into a template.<br> | ||
+ | Comments in templates should be adjacent to the line it is commenting on, or directly above the relevant section. | ||
− | + | All templates should be documented with the following headings (if necessary):<br> | |
− | + | {{arrow}}Description (required)<br> | |
− | + | {{arrow}}Parameters (using the <code><nowiki>{{parameter}}</nowiki></code> template)<br> | |
+ | {{arrow}}Usage (required)<br> | ||
+ | {{arrow}}Examples (for complicated templates)<br> | ||
+ | {{arrow}}Template-Specific Headings (for extra clarity)<br> | ||
+ | {{arrow}}Errors (any and all usages of <code><nowiki>{{error}}</nowiki></code> should be documented here) |
Revision as of 17:10, 25 February 2023
The Corepunk wiki strives for a comprehensive archive of information about the videogame Corepunk. As such, it allows anybody to contribute, no matter how big or small the contribution. You do not need to register to contribute to the wiki. If you don't register, your edits will be publicly linked to your IP address.
General
Important editing guidelines. Anyone editing the wiki should familiarize themselves with these rules.
Content
If a page is long, a summary section containing key information should be written at the top of the page.
Content should be written in American English, in an unbiased, formal manner. They should be as concise as possible whilst still being readable to most users and without loss of information. Content should be relevant and should not be a narrative short story.
Appearance
Editors must ensure articles have a consistent and standardized appearance. This is done through the use of templates.
We aim for a visual style similar to that of Corepunk's official website, but without outright plaigarism.
Uploading
Files should be uploaded as .jpg
files. This makes load times for pages with many images significantly faster.
When taking screenshots, ensure the image quality is the highest possible before compressing. This means all graphics settings should be set to their maximum values.
All files must have the correct license attributed to it, and editors must use the file in accordance with the license.
Sourcing
Content on the Corepunk Wiki must be properly sourced, with copyrighted images as a priority. Copyrighted images must be used such that they qualify under fair use (i.e. these images must be used for educational purposes).
Minor Edits
A minor edit signifies that a small, superficial change has been made to the previous version. This may include, but is not limited to: fixing typos, spelling and/or grammatical mistakes; altering page appearance and/or structure; updating inaccurate information; or addition of detail that is of little importance to the overall article.
To signify a minor edit, tick the checkbox labeled "This is a minor edit" above the "Save changes" button. Minor edits are not enforced, nor are they meant to be: they provide an at-a-glance summary of what changed about an article. Marking an edit as minor does not mean the contributor should forgo writing an edit summary. Editors should not feel that marking an edit as minor devalues their contribution in any way.
Major Edits
Major edits are, simply put, edits that are not considered to be minor. Editors should first consider adding to to the relevant talk page and getting consent from relevant editors first before making the contribution. If an edit takes place over an extended period, consider using the {{in use}} template to prevent edit conflicts.
Article Creation
Before article creation, ensure that it is necessary and relevant to Corepunk. Novice editors are reccommended to begin with smaller edits first before creating a new article.
Talk Pages
Talk pages are used to discuss possible changes to a particular article before it becomes a submitted contribution. If an editor is unsure about a contribution, it is reccommended to ask in the article in question's related talk page.
Editors should sign their contributions to a talk page with their signature with four tildes (i.e. "~~~~")
Documentation
We strive for a wiki such that the average user can look at our source and understand its general function.
In general, a page's source should be documented with comments if it is hard to read and/or understand. This means all code that isn't self-explanatory should be commented.
Naming Conventions
Pages and headings should be named formally, concisely and sensibly. It should convey a general idea of what the section is about.
Templates
Main
Templates are snippets of wikitext to be included in articles. It is similar to a class in object-oriented programming.
They are used by this wiki as a means of standardization and ease of use. In general, if a snippet is repeated across multiple pages, it should be abstracted into a template.
Comments in templates should be adjacent to the line it is commenting on, or directly above the relevant section.
All templates should be documented with the following headings (if necessary):
Description (required)
Parameters (using the {{parameter}}
template)
Usage (required)
Examples (for complicated templates)
Template-Specific Headings (for extra clarity)
Errors (any and all usages of {{error}}
should be documented here)