Guidance for Scribes

This article is an evolving style sheet to help guide contributions to the wiki. While we're developing it, please join the conversation on the talk page. For suggestions on what to work on and wiki tutorials, check out the Wiki Portal and the contribution board for this Wiki.

Mission
Our goal is to create and maintain an accurate, up-to-date and easy-to-use guide for players of HabitRPG.

The quick reference card to the right is a printable version of the critical parts of these guidelines, but you should read through this Wiki page for full details.

How to Start
You can begin contributing to the HabitRPG wiki by signing up for a Wikia account. Your username does not have to be the same as your HabitRPG username in order for you to earn credit for your work when requesting a contributor tier. Be sure to sign in to wikia so you can get credit for your edits.

Before making major changes, use each article's talkpage to discuss article contents and resolve any conflicts. Respect is key.

Please read The Keep:The Knights Chambers to understand the process for requesting a contributor tier and the kinds of wiki changes that are preferred.

Tone
Informative and semi-professional. In practice, this means opening all articles with clear-cut and concise definitions of the topic in question, followed by a well-organized and thorough rundown of the topic in detail. Stick with third person only in the openings, using words like "player" and "user" rather than "you." Once you get into the meat of an article, it should be fine to use second person, as most articles will have instructions for users of the site to follow. Never use first person under any circumstances.

Article length
Keeping the tone in mind, the article should be informative. The article should be straight to the point and should be as long as need be (especially for broader topics). However, do not go on a tangent and add fluff. Shorter articles are generally more accessible and usable than really long ones. Referencing related pages, however, is recommended and helpful for users in general. Always write the best that you can on all of your contributions.

Text
Formatting of text can include bold or italic text. These should be used sparingly. Text with too much formatting is distracting and decreases readability. When it comes to text decoration (overline, underline, etc.), we try to avoid these at all costs. Usual formatting of text does not need strikethrough, and underlined text can easily be confused with hyperlinks.

Margins and Padding
Margins and Padding are names for space around an element, be it text, image, table, etc. As a wiki editor, you usually do not have to worry about this. When you get further into it, this can be handled via CSS and the style attribute. You can read up on the use here: margins and padding.

Grammar
On this wiki, we follow standard English grammar rules.

This includes (but is not limited to) spacing, punctuation and capitalization. Spacing is set to one space between sentences. Abbreviations should be followed by periods (for example, e.g. and i.e.). Entries should be made in sentences, not note form, unless entering data in a list or table.

We also use standard English capitalization. This has two main cases: (If you need more information, please see Wikipedia.)
 * 1) At the beginning of sentences.
 * 2) With certain nouns (usually proper nouns, or HabitRPG terms such as "Market") and some adjectives. See Capitalization, below.

Do not write in all caps; writing in all caps is considered to be the equivalent of yelling on the Internet, and as such it is against the proper tone of this Wiki. If you need to emphasize something, you should use the bolding and italicizing features of the wiki (but make sure you aren't using these in excess!). If you see improper grammar in a wiki page, feel free to edit it! In addition, make sure you double-check (and maybe even triple-check) your edits after writing them to make sure you don't have any grammar bugs lurking on the page.

Spelling
American English is the standard for spelling rules on this wiki. This means that color, personalize, and center are the correct spelling, while colour, personalise, and centre are not (read more).

The one exception to this rule is the spelling of grey. While American English generally uses gray as the standard spelling, this wiki, as well as HabitRPG, do not. In order to remain consistent with the rest of the wiki and between the wiki and HabitRPG, the standard spelling shall be grey (read more).

It is requested that edits are not made only to change British English to American English unless it interferes with the functioning of a link or it is the incorrect spelling of a name. It is acceptable to change it while other substantial edits are being done, though, in order to improve consistency with the rest of the wiki.

Capitalization
"HabitRPG" should always be capitalized as shown (except in certain technical contexts, such as programming applications).

Standard English rules of capitalization are almost always followed. For example, proper nouns are capitalised (e.g., America, Habitica). One exception is when a player has chosen to write their display name in lower case; please respect the player's choice and use the same capitalisation they do (e.g., the moderator deilann should not have his name written as "Deilann").

Terms that have a special meaning in the context of HabitRPG should be capitalized. For example, Strength is a character attribute; strength is something else (as in "I want to increase my physical strength so I have created several tasks with the Strength attribute").

Words that refer to more general concepts in the game do not need to be capitalized. For example, "sword" in HabitRPG has the same meaning as it has in the real world and so is lower case.

The tables below give some examples of those guidelines.

For capitalization of headers and subheadings, please see the chapter on Headers below.

Tables
Tables should be styled as they appear when the add table feature is used in the visual editing mode of the classic editor. This does not apply to sorting tables, or excessively large tables (see Mounts). Parameters in source mode for this are: border="0" cellpadding="1" cellspacing="1" class="article-table" style="width: 500px; If you'd like to create tables using a graphical interface, TablesGenerator.com allows you easily create MediaWiki tables that then be copy-pasted into the wiki.

Colors
Use colors sparingly so as not to disrupt the global style. Colors should not be used for any text as they can be confused with broken links or links to other pages.

Links
Try to add relevant internal links to articles, so that dead-end pages are avoided, and to help people browse the wiki. External links to GitHub issues and Trello cards can provide useful behind the scenes or historical information.

When creating links on a page, make sure that you link to the current page for the topic in question, and that the target link in the source code (or edit link box) is appropriately capitalized. Because the wiki is a work in progress, pages are occasionally consolidated, removed, or renamed. For example, the Gold Points page has previously been named Gold Points (GP) and Gold Coins. To prevent issues when other sites have linked to the pages on the wiki that no longer exist, the admins leave redirect links to deleted pages. This means that when new internal links are created, the auto-fill suggestion box includes these old link names. When wiki users click these old links, they are redirected to the new page. The new page alerts the user to the old link redirect with a message below the page title, "Redirected from [old page name]", as can be seen using the links in the above example. Link targets that are not capitalized in the source code also give this message. This issue does not affect functionality of the wiki, but using the correct link and preventing these messages improves the sense of professionalism that the wiki strives for.

Headers
Use headers liberally to break up articles, enable easier reading, and allow the automatic generation of tables of contents. Try to avoid too many subheadings as this can make the text harder rather than easier to read.

Headers and subheadings should not be changed unnecessarily since they can be linked to from other pages and from locations outside the wiki (e.g., HabitRPG itself, GitHub, and blog posts). Any change to a heading will make these links nonfunctional. If it is essential to change a header, please also correct all links leading there from elsewhere in the HabitRPG wiki. Also search through likely locations in the HabitRPG website (habitrpg.com) to look for links to the heading. If you find any, create a new issue in GitHub to ask that the link be changed.

Headers and subheadings are capitalized according to the usual English rules for headers. For more information about these, please see Wikipedia. However if you see an existing header that does not have correct capitalization, please do not change it unless you are certain that there are no links to it.

Infoboxes
Individual item pages should have a infobox with an image, the tooltip description, and buy/sell prices - instead of listing this info in paragraph form. Example code for the template is as follows.

Titles
When creating new pages, please do not use parentheses in the title of the new page. This is due to a conflict with the formatting in the Tavern - wiki pages with parentheses in the title will glitch.

Table of Contents (TOC)
The table of contents (TOC) will automatically generate after the fourth main sub-heading. The TOC can be forced to appear with less than four sub-headings by including the following code in the source view of the editor at the start of the wiki document: To shift the TOC to the right of the page, enter the following code into the source view of the editor at the top of the wiki document:

Avoiding Spoilers
When looking for new information to add to the main namespace, stick to features that are already implemented, visible, and accessible to all players on HabitRPG. Though there is a tremendous amount of information about planned or upcoming features available on GitHub and the various Trello boards, this may contain spoilers that the staff wish to keep as surprises for players. This is particularly important for world events, particularly those with multiple event-based reveals like the battles with tavern bosses. It is, of course, okay to discuss quest lines in designated areas like the Camp.

For spoilers of already implemented content, such as resolution text for boss or collection quests, you can use the templates for spoilers, Template:Spoiler start and Template:Spoiler end. The spoiler warning template, Template:Spoiler should be used on pages such as the Camp, where most or all content are spoilers.

File types
All images should be uploaded as PNG with transparent backgrounds with the highest resolution available.

Note: Check here before uploading new images. The image you want might already be uploaded. If not, you can find many of the original items/food/pets/mount images here.

File Names
Images being uploaded should be named with generic but descriptive titles. The name should accurately reflect the content of the image, distinguishing it from other images, without describing elements of the image that may be changed as HabitRPG evolves. Try to avoid using words in the name that would be inaccurate should the image need to be updated in the future to represent changes to HabitRPG. For example, the image on the right was uploaded to show what the buff icon looks like on an avatar. It was named Avatar_Buff.png.

Avoid including any words in the image's name that are likely to become irrelevant when the image changes: An exception can be made if it is absolutely necessary and not likely to change (e.g., July_2014_Mystery_Item.png).
 * Dates (e.g., Avatar_Buff_August_2014.png)
 * Version numbers (e.g., Avatar_Buff_version_1.png) or words indicating a new version (e.g., Avatar_Buff_updated.png or Avatar_Buff_modified.png)
 * Avatar names (e.g., Deborah_Buff.png)
 * Elements in the image that might change when the site is updated, such as colors or shapes (e.g., Buff_White_Arrow.png)

Captions
Use the caption to explain what the picture shows, and to clarify why it is included in the page.

Wide Captions
When paired with smaller images, some captions may wrap undesirably as seen to the right. You can use the infobox item template as follows to render the image without undesired wrapping:

Replacing v. Deleting
Outdated images should be replaced rather than deleted if at all possible. Go to the image's page, then select the drop-down menu on the edit button next to the title. You will see the following options: History and Replace. Click on replace, then use the form displayed to upload the updated image. You can write a brief description of what has changed in the image, or why a new version is needed. Once the form is submitted, the old version of the image will be replaced by the new one, but the old version will still be available in the file's history tab.

Note: There is an ongoing issue with the Wikia caching so that for a little while after a replacement image is uploaded, the old image still shows. Wikia seems to occasionally have very aggressive caching that can hold on to the old version of an image for hours. It should rectify itself within a day, but if it doesn't, the issue can be reported to wiki staff and they'll manually clear out their cache. See also the Wikia Community Central's Help:Purge page.

Using this method to replace an old image has a lot of advantages over uploading a completely new image. It means that you can see all versions of an image in one place, and it's very easy to revert to an old version if needed. It means that all links on the wiki and elsewhere will keep on working. It reduces clutter in the wiki's "Photo" section because there's only one entry for each image.

Most importantly, it makes it impossible for anyone to accidentally use an old version of an image. Someone who's editing a page and needs to choose an image will find it hard to pick the right one, and if more than one similar image is used across the site, then all of them have to be updated when HabitRPG changes. But if new versions of images are uploaded to "replace" old images rather than uploaded as new images, this issue disappears.

Check out this thread for more explanation of why it's generally better to replace rather than delete.

Copyright
Please include the origin of images, the author, and the copyright information when uploading images. Images uploaded from HabitRPG can easily be identified as such through the drop-down menu in the upload section.

Images from HabitRPG are licensed under the CC-by-NC-SA 3.0 license. To add the appropriate image licensing information, type  on the image information page for HabitRPG artwork and screenshots.

Adding Spacing and Preventing Awkward Overlaps
If the image is creating issues with the layout, you can add the following code to create a clear space to fix it.

Wiki Promotional Art
Some pages have decorative promotional art, depicting Habiticans engaging in activities relevant to the material on the page. These images can add flavor and help break up large areas of text. If you find a page that could benefit from this type of art and have an idea for it, submit your idea to the appropriate card on the Pixel Art Trello. Once your idea is approved, it will be added to a list of scenes needed. Artisans will then be able to claim and create the scene.

As wiki promotional art is decorative, it does not require captions.

Videos
Videos can be included from Youtube as well as Vimeo. These should improve the article significantly to be included.

Categories
Categories can be added to articles to group them according to a certain topic. Generally, these categories should add value to the article.

Edit Summaries
When making edits, write a short summary of the changes that have been made in the 'Edit Summary' box before publishing. Depending on the edit, a few words may suffice, but major edits may need longer summaries or the inclusion of rationales. Providing these summaries allows other scribes to quickly get a sense of what has changed. It is also extremely helpful when filling out contributor tier applications, as these summaries are shown as part of the edit histories on user profiles in the 'Contributions' tab. In addition, it makes finding specific changes in a series of edits much easier.

Renaming Pages
On rare occasions, pages may need to be renamed. When pages are renamed, wikia will automatically create a redirect page that will take old links to the new site. However, links on the wiki will not be updated automatically. The wiki will still function, but users will be alerted to the fact that the link is old with a message below the page title, "Redirected from [old page name]". To eliminate this message and maintain the sense of professionalism that the wiki strives for, you can use the special page WhatLinksHere to find those out of date links that renaming has created, and fix them. Simply type the old page title into the appropriate box, and they will be displayed.

Deleting
If there are occasions for pages to be renamed, there will also be occasions for pages to be deleted. Only wiki admins can delete pages. If you think a page should be deleted, enter the classic editor and open the source tab. At the top of the page, add the following code with your reason for suggesting deletion:

Keep in mind that at this time, redirect pages are a permanent fixture for the wiki. The wiki is here to provide information to the users in a way that's convenient for them to use. Broken external links, whether from an outside site, the HabitRPG forums, or a page that a user bookmarked, make it less convenient for the readers to use the wiki. Therefore, redirect pages are kept in place so that these links will not give a "404 Page Not Found" error. This ensures that wiki users have a better experience when trying to locate information, and increases the wiki's efficiency in providing consistent, up-to-date information. Remember, our goal is to create and maintain an accurate, up-to-date and easy-to-use guide for players of HabitRPG, so if there is a redirect page that you firmly feel needs to be deleted, at the top of the page add the deletion code with the reason that the page should be deleted. From there, the wiki admins will discuss the reason and make a decision, and the page will either be deleted, or the deletion code can be removed.

Creating a User Sandbox
A Sandbox is a page that can be used to practice editing, to learn the formatting, and to put together drafts without necessarily publishing it to the main page. If you are someone who learns by doing, having a sandbox where you can try out code, formatting, and design can be very useful. Below are the steps to create your sandbox.

1. '''Go to your user page. '''You can do this by clicking on your user icon at the top right of any wiki page. You may have to click twice, if the first click opens up the menu.

2. Add /Sandbox to the end of your URL. Click on the URL box in your browser, deselect the text, and type in /Sandbox at the very end of. Go to this page.

3. Since you have not yet created your sandbox, you will have the option to do so here. Right next to the page title, click the Create button.

4. If it opens up in the visual editor, select the option to open the source editor. You can find this option by clicking on the drop-down menu next to the Cancel and Publish buttons, and selecting Source Editor.

5. Paste the following code into the text box: 6. Below this pasted text, you can begin to practice editing. One idea to begin with is to add a table of contents and links to useful templates and code that you often need to look up.

7. Whenever you are finished​ editing in the so​urce editor, click Apply Changes on the bottom right of the frame.

8. Click on Publish to save your page.

9. To find your Sandbox easily, add a link to it on your profile page. You can do so by pasting the following code into the source editor of your user page (found by clicking on your user icon, selecting Edit Profile under the Profile tab, and selecting the Source Editor option), replacing "Username" with your own username: My Sandbox 10. Voila! You now have a Sandbox of your own! Experiment with it as you please!

Toolbar
If you have a wiki account, you can utilize the toolbar that is at the bottom of your screen to use shortcuts and other tools to do various functions. You can find more info on the toolbar here.

For a list of available toolbar tools see this page.



Disabling Ads
If you have a Wiki account and wish to disable ads, you may go to your preference page and scroll down to the ads setting and select "Don't Show all Ads".