Style Guide

The following conventions are a set of rules that apply when editing information on this Wiki. This page should be added to one's list of followed pages​.

## Writing style

Proper grammar and spelling must be used along with an impersonal and formal style. For example, one must not write: "You should," or "you can get," but rather "players can."

The standard language used is American English. When writing thousands/millions, a comma and **not** a period must be used as a separator. Example: 1,250 Gold/Hour; 25,225 Health; and so on.​

​

## Sectioning Pages

Pages should have a brief introduction, then have sections whose headers should describe what something is/does and the *actions* players would want to preform with/in them. Then, under each section the different should be descriptive text for each. For example, a page may have an introduction explaining where it is located, then a *Function* header with text describing its function, then an *Accessing* header, describing how it is accessed. The actions headers should be plural, i.e., *Accessing* and not *Access*.

With each new action/function add a new header if there is sufficient text to do so. Group subordinate or sub tasks under their respective header. Headers automatically create a Table of Contents (TOC) on larger pages, making it really easy for players to scan its entries, chose one, then click to learn about how something works in the game. Then, in the section they chose, they find a concise description of the features.

## Capitalization and specific terminology

### Capitalization

In general, words that are designed to refer to names, or to specify a particular object, are capitalized. For example, the word *level*, when used in general, is not capitalized, but it is when specifying a particular level. For example: *the player unlocks this item at Level 4*.

Some words, both the word itself (in both singular and plural forms) and what they refer to, when referring to in-game features or mechanics, are always capitalized (except for prepositions contained within them). As such, when referring to in-game characters or items, the word is capitalized, but when in general speech, it may not be.

## Images

All images should be named how they appear in the game, capitalized as it appears in the game, with spaces replaced by underscores, and leaving out special characters that make urls "ugly". For example, *Esmerelda's Tent* would be named *Esmereldas\_Tent.png*.

Images that may in the future require transparency (buttons, buildings, crops, icons, characters etc.) should always be png format, because this supports transparency, whereas items that won't ever need transparency like boards/interfaces/help dialogs etc., should be in jpg format. Jpg files are smaller file sizes because they don't support transparency.

## Linking and categorization

### Linking

Whenever something having its own article on the wiki is referenced in another article, it must be linked at least once.

If one wishes to change the text which is displayed for a link that is shown, first type that text, then select it, then press the link button. For Source Editing, place a pipe "|" character (followed by the desired text to be shown) that must be added before the closing brackets. `[[Achievements|Achievement]]`​ becomes: Achievement.

External pages can be linked also, either through the editor by typing the text and pressing the link button; or, in Source Editing mode by adding a single opening square bracket, then the URL of the page (including the https:// part) followed by a space, the desired text, and a single closing square bracket. So, for example, [https://royalfarm.ugo.company/ Royal Farm]​ becomes: Royal Farm.

 *See | Links Help for information on how to link to other articles.*​

​

### Categorization

All articles and files (pages and images) must be properly categorized. Depending on the type of article/file, the required categories can be found here.

 *See |Category Help for information on how to categorize articles and images.*​

​

## Templates

 *See Fandom Template Help for in-depth documentation about templates and their proper use*​

.

Templates are used when content needs to be reused on multiple pages, or when a specific item (it could be a formatted/sized image, link, calculation, text etc.) might be needed in more than one place. They are also used to control the formatting of specific items, like in-text icons. See the category for information on specific templates and how to use them (their accepted parameters and such).

Some templates can also accept parameters that help to control the desired output. This is where templates are extremely useful. Templates use on pages allow the data stored as values to be queried and retrieved for automatic tables, lists and other data displays.

##### **Use Human-readable Template Format for non-inline elements**

In Infobox templates (the templates that create right-side information boxes on pages) always use human-readable template format, that means this:

```
Example to be added here.

```

**And NOT this:**

```
Example to be added here

```

**IMPORTANT:** Using the above format causes issues with templates used inside of parameters in combination with DPL3 to generate automatic tables (when the template appears last in front of the template closing curly braces). So please avoid that inline template format, to prevent issue with dpl and to make templates much easier to read and understand for new users.