TODO: Rework to describe new site
Guidelines for wiki editors
Table of contents
Requirements
- Ability to write text that conforms to these guidelines and follows the Text Formatting Rules.
- Have the desire to actively maintain site articles, movie descriptions, or fixing grammar/spelling/punctuation/formatting errors on the site.
- Want to become an editor? Simply ask a site admin or admin assistant (either by forum PM or by Live Chat).
- Note that in order to edit Game Resources pages, one must either have at least one published movie or be granted permissions by an admin or admin assistant.
When editing pages just keep the following rules in mind.
General
- Be considerate, especially when correcting a mistake another editor has made.
- Leave some time after another contributor's edit before editing a page yourself; they may have minor corrections to make.
- Also, try not to edit pages in rapid succession yourself. Minor corrections are acceptable, but please try to accomplish what you are trying to do with as few edits as possible.
- No marketing speech. Write from a neutral point of view.
- You will not be able to edit system pages; this includes pages with "System" in the title and a handful of other significant pages.
Minor edits
- All non-minor edits are reported immediately to IRC and Discord. If you are testing functionality or are just an obsessive editor, either use the preview button, or check minor edit so your edits do not disturb live chat channels. After you are sure that you are done, you can make a dummy edit and save without checking the minor edit box, if you make a significant change. This includes the Sand Box.
- Please don't do mass changes (a small change that is done to 10 pages at the same time), unless you have discussed their need with other editors. Each edit creates a new copy of the page in database, and the site administration prefers quality over quantity.
Understandable writing
- Write in a way that is easy to understand. Avoid slang and internet shorthand. For some of the site's viewers, English is not their first language.
- Structure your text carefully, so that the reader does not have to spend unnecessary effort in understanding what is written:
- Exercise good spelling, grammar, and structure.
- Use active words. Avoid using passive words like “get” and “have”. They are easily misunderstood and also don't machine-translate well.
- Avoid acronyms unless they are well-established in their context. It may help to describe what an acronym stands for the first time it is used on a page.
Editing and commenting
- The main rule is to contribute anonymously and without a personal reference.
- If you represent yourself (“I think...”), you should prefix your comment with a link to your homepage (“Bisqwit: I think...”) or suffix it (“I think... --Bisqwit”).
- The purpose of the edit summary is to describe to others what you changed. Do not use the edit summary as a discussion vehicle. If you must discuss something, do it in the page, on the discussion forum, or in IRC.
- Keep in mind that your edit summary, if it is a non-minor edit, will normally be posted to Live Chat channels so as to keep others informed of your work.
Wiki markup guidelines
- Learn the text formatting rules. If you are familiar with text formatting, it becomes much easier to structure your writing.
- Do not overuse emphasis.
- If referring to tasvideos users by username, use the [user:foo] syntax (instead of foo or [foo]) so it will properly link to the user's homepage if or when the user has one.
Creating new pages
Step by step guide:
- Think of the purpose of this site. Does your planned page serve the audience of the site?
- Think of a name for your page. The name should contain the essence of the page’s topic. For example, a page for TASVideos site history would be Site History.
- Don't use characters beyond A-Z, a-z, 0-9 and '/'.
- The name should be as short as possible (for easy remembering and easy linking). Do not use acronyms (see above).
- If there is danger of confusion (there are multiple different games by the same name, but you are writing only about one of them, for example), add more words to the name.
- Edit an existing page and add a link to that new page. The Text formatting rules explains how to create links. This step is to avoid it becoming a Wiki orphan.
- Then click the newly created link, which will take you to the page you wanted to create.
- Game Resources are organized as subpages and linked automatically on their parents. To create such a subpage, just enter the desired URL into the address bar and edit the page. For example for NES Super Mario Bros your URL will be
https://tasvideos.org/GameResources/NES/SuperMarioBros
.
- Game Resources are organized as subpages and linked automatically on their parents. To create such a subpage, just enter the desired URL into the address bar and edit the page. For example for NES Super Mario Bros your URL will be
- Click the Edit link on that page.
Movie editing
TODO: update
Editors will see an small edit button on the bottom right hand side of a movie module. This allows them to access the movie edit page.
Description
Edits the movie description text.
Headers
Ability to edit the Player name, Platform, Game name, Game version, Branch name, ROM filename and the "Hacked movie" status. Accessed from the Edit info button.
- Do not change the player without good reason (and admin approval).
- Follow the Publisher Guidelines regarding giving the proper Game Name, Version, Branch, ROM Name, and Movie filenames.
- The "hacked game or otherwise impure movie" checkbox places the movie in the Concept/Demos category.
Tags
Ability to edit the movie categories (such as "Heavy Glitch Abuse"). Clicking "edit classes" brings up a list of available Tags.
When editing movie tags, follow the Movie Tag Guidelines.
See also:
- Text Formatting Rules
- User pages (a.k.a. homepages)