| Latest revision |
Your text |
| Line 1: |
Line 1: |
| − | As of March 2021, there is a concerted effort to improve the wiki over on the Dominion Discord server. Come join us: https://discord.gg/GqFQ97e2wH -- we have improved {{ #expr: {{PAGESINCATEGORY:Cards|pages}}-{{PAGESINCATEGORY:Needs Improvement|pages}} }}/{{PAGESINCATEGORY:Cards|pages}} articles in the project. | + | As of March 2021, there is a concerted effort to improve the wiki over on the Dominion Discord server. Come join us: https://discord.gg/VVqG2GGR |
| | + | |
| | + | == ToDos == |
| | | | |
| − | ==To Dos==
| |
| | '''Logistics:''' | | '''Logistics:''' |
| − | # Figure out exact edit process | + | #Figure out exact edit process |
| − | # Generate list of pages to edit, prioritize | + | #Generate list of pages to edit, prioritize |
| − | # Figure out template for said pages. | + | #Figure out template for said pages. |
| | | | |
| | '''Wiki content:''' | | '''Wiki content:''' |
| Line 11: |
Line 12: |
| | | | |
| | '''Wiki formatting/structure:''' | | '''Wiki formatting/structure:''' |
| − | # pages with lists of cards to have visual spoilers for them | + | #pages with lists of cards to have visual spoilers for them |
| − | # front page to link to the category pages like "village" | + | #front page to link to the category pages like "village" |
| − | # Better card art scans | + | #Better card art scans |
| − | | + | |
| − | | + | |
| − | ==Style guidelines==
| + | |
| − | These guidelines borrow from the [http://wikipedia.org/wiki/Wikipedia:Manual_of_Style Wikipedia Manual of Style].
| + | |
| − | | + | |
| − | ===Retain existing styles===
| + | |
| − | When you encounter a situation where more than one style is appropriate, prefer the one already in use. Do not simply edit something to change between acceptable styles. Do edit from an incorrect style to a correct style.
| + | |
| − | | + | |
| − | ===Page titles===
| + | |
| − | Use the most recognizable and descriptive name for that topic. For official items like cards, tokens, and concepts, use the names as defined in the rulebooks. Capitalize the initial letter and otherwise follow sentence case, except where capitalization is used in Dominion text. For example, use “Three-pile ending” and not “Three-Pile Ending”
| + | |
| − | | + | |
| − | ===Section organization===
| + | |
| − | Each page should begin with a concise introductory summary. Infoboxes, images, and other related content should be right-aligned. Infoboxes and banners should be included before the introductory text. Tables of contents are inserted automatically. Navboxes should appear after the main body.
| + | |
| − | | + | |
| − | ===Section headings===
| + | |
| − | Follow the guidance for page titles. Use equals signs around a section heading: <code><nowiki>==Heading==</nowiki></code>. Do not skip heading levels. Spaces around the title are optional: <code><nowiki>== Heading ==</nowiki></code>.
| + | |
| − | | + | |
| − | Section headings should not:
| + | |
| − | * Be repeated within a page.
| + | |
| − | * Contain links (whether external or internal).
| + | |
| − | * Images or icons.
| + | |
| − | * Templates (which use curly braces <code><nowiki>{{like this}}</nowiki></code>).
| + | |
| − | * Use colors, italics, or other formatting.
| + | |
| − | * Include manual line breaks.
| + | |
| − | * Refer to the page title or a high-lever heading. For example, use “FAQ” instead of “FAQ for Village”.
| + | |
| − | * Be numbered or lettered like a list.
| + | |
| − | * Be phrased as a question. For example, use “Strategy” instead of “What is the strategy for Smithy?”.
| + | |
| − | | + | |
| − | It is possible to link directly to a section title. So before changing any headings, consider whether it may break existing links.
| + | |
| − | | + | |
| − | ===Varieties of English===
| + | |
| − | The Dominion Strategy Wiki is written in English. American English is the default, but other varieties are allowed; be consistent within a page. Use terms universal to all English varieties when possible, instead of regional terms.
| + | |
| − | | + | |
| − | ===Capitalization===
| + | |
| − | Do not capitalize ''the'' in the middle of a sentence. For example, use “follow the Penultimate Province Rule” and not “follow The Penultimate Province Rule”.
| + | |
| − | | + | |
| − | Follow the same capitalization styles for Dominion terms as used in the rulebooks. For example, always capitalize:
| + | |
| − | * Expansions.
| + | |
| − | * Card and landscape names.
| + | |
| − | * Card and landscape types.
| + | |
| − | * Groups of cards such as Supply, Kingdom cards, and Base cards.
| + | |
| − | * Mats, except the Trash mat when not accompanied by ''mat'' or ''pile'': “the Trash mat”, “the Trash pile”, “the trash”.
| + | |
| − | * Tokens but not the word ''token'', for example “Debt token”.
| + | |
| − | * Phases but not the word ''phase'', for example “Clean-up phase”.
| + | |
| − | * Amounts with pluses, such as +Cards, +Buys, and +Coffers.
| + | |
| − | | + | |
| − | And for example do not capitalize:
| + | |
| − | * Some zones of cards such as play area, discard pile, and set aside.
| + | |
| − | * Most defined Dominion actions such as play, gain, and reveal.
| + | |
| − | * Words that are Dominion terms, but aren't being used in their specific Dominion sense. For example, "''gain'' an advantage" and "''attack'' your opponent".
| + | |
| − | | + | |
| − | For unofficial terms, do not capitalize general concepts such as “engine” and “pile out”. Do capitalize names of specific concepts such as “Big Money” and “the Penultimate Province Rule”.
| + | |
| − | | + | |
| − | Capitalize real names of real people. Capitalize usernames as the person chose to create them. For example, “Donald X. Vaccarino” and “LastFootnote”.
| + | |
| − | | + | |
| − | ===Abbreviations===
| + | |
| − | Abbreviations here includes initialisms and acronyms. In general avoid abbreviations. Never abbreviate official Dominion terms; for example, always use “Ill-Gotten Gains” instead of “IGG” and “turn 3” instead of “T3”.
| + | |
| − | | + | |
| − | When using abbreviations, write out the full version and the abbreviation the first time it is used in a page. Follow normal capitalization rules for the unabbreviated terms. Avoid using periods in abbreviations; for example, use “PPR” instead of “P.P.R.”.
| + | |
| − | | + | |
| − | ===Grammar===
| + | |
| − | * '''Possessives''': For plural nouns ending in ''s'', add an apostrophe. In all other cases, including names, add ''’s''. For example, “both cards’ opportunity costs are low” and “Gardens’s illustration is by Matthias Catrein”.
| + | |
| − | * '''First person''': Never refer to the writers or readers using ''I'', ''my'', ''we'', ''us'', or similar forms.
| + | |
| − | * '''Second person''': All strategy and rules information should prefer referring to the reader using ''you'', ''your'', or similar forms.
| + | |
| − | * '''Third person''': All strategy and rules information should prefer referring to the reader’s player opponents using ''they'', ''their'', or similar forms. Some strategy information may be suitable to use third person forms to convey generalized advice, but use second form when possible.
| + | |
| − | * '''Verb tense''': By default, write pages in the present tense, including those covering [[removed cards]]. Generally, do not use past tense except when referencing removed cards or rules that have been superseded by errata.
| + | |
| − | | + | |
| − | ===Vocabulary===
| + | |
| − | * Use generally-neutral language. For example, use the singular ''they'' instead of ''he'' or ''she''. An exception to this is when using names of things from Dominion (for example, {{Card|Night Watchman}}).
| + | |
| − | * Avoid words that are exceedingly informal or opinionated. Strategy advice is often opinion-based, but prefer statements that are commonly accepted. Do not editorialize.
| + | |
| − | * When providing examples, use cards from the {{Set|Dominion|Base game}} if possible as more players are familiar with those.
| + | |
| − | | + | |
| − | ====Official terminology====
| + | |
| − | Freely use Dominion terminology defined and used in the rulebook. In particular, note the following:
| + | |
| − | * Amounts with pluses are given and gotten, using the words “give” or “get”. For example, use “{{Card|Militia}} gives +{{Cost|2}}” instead of “{{Card|Militia}} generates {{Cost|2}}”.
| + | |
| − | * A single Coffers token still uses the plural ''Coffers''.
| + | |
| | | | |
| − | ====Jargon====
| + | '''Specific pages:''' |
| − | Avoid excessively using unofficial community jargon. If you do use jargon, link to the page explaining it and if it’s a page relating to the base game, consider including a brief definition. For example:
| + | #To be decided... |
| − | * '''Base''': consider "Dominion" (the official term), "Base set", or "Base game".
| + | |
| − | * '''Draw deck''': consider “draw your deck” instead.
| + | |
| − | * '''Pile pressure''': consider “threaten a [[three-pile ending]]” instead.
| + | |
| − | * '''Pop''': consider “trash”, “activate”, or something more specific.
| + | |
| − | * '''When-gain''': consider “a ‘when you gain’ ability” instead.
| + | |
| − | * '''Topdeck''': consider “put onto your deck” instead. (Take special note that some games use this term differently than Dominion, so it is clearer to avoid it.)
| + | |
| − | * '''Vanilla bonus''': consider “+Cards, +Actions, +Buys, or +{{Cost}}” instead.
| + | |
| | | | |
| − | Note that when “hand size” is used an adjective it is customarily written as one word.
| + | ==Style and Editing Guidlines== |
| | | | |
| − | Try to refer to costs using the same conventions as Dominion cards. For example:
| + | === Capitalization === |
| − | * Use “{{Cost|4}} or more” instead of “more than {{Cost|3}}”.
| + | |
| − | * Use “a card costing {{Cost|5}}” instead of “a {{Cost|5}}-cost card”.
| + | |
| − | * Use “costing from {{Cost|3}} to {{Cost|6}}” instead of “costing {{Cost|3}}–{{Cost|6}}”.
| + | |
| | | | |
| − | ===Bulleted and numbered lists=== | + | ====Things that should be capitalized==== |
| − | Do not use lists if a passage is read easily as plain paragraphs. Do not leave blank lines between items in lists. Only use numbered lists when necessary; prefer bulleted lists by default.
| + | *Names of cards and non-card things printed on cards (Events, Landmarks, etc) |
| | + | *[[Sets#Releases|Sets]] |
| | + | *[[Card types]] |
| | + | *Some areas of cards: Supply, Kingdom, and Trash |
| | + | *[[Gameplay#Turn_Phases|Phases]] (Action phase, Buy phase, Night, and Clean-up phase) |
| | + | *[[Vanilla bonuses]], (+Cards, +Actions, and +Buys) |
| | + | *Actions and Buys |
| | + | *Token names ([[Coin tokens]], [[Victory tokens]], [[Adventures tokens]], and [[Debt|Debt tokens]]) |
| | | | |
| − | Use the same grammatical form for all items in a list. For example, do not mix full sentences and sentence fragments.
| + | ====Things that should be lowercase==== |
| | + | *Some areas of cards: play, hand, deck, discard pile, set aside, etc |
| | + | *Words with meaning specially defined for Dominion, but not listed in the previous section (discard, gain, reveal, etc) |
| | | | |
| − | ===Links===
| |
| − | ===Wikilinks===
| |
| − | Make links only where they are relevant and helpful in context. Only link to a page the first time it is relevant in each section of the page.
| |
| | | | |
| − | Only capitalize the first letter if it would be normally capitalized. Wikilinks are not required to begin with a capital letter like the page itself.
| + | What about certain terms like Big Money or Engine? I see both of them capitalized or not sometimes. --[[User:Jonts|Jonts]] ([[User talk:Jonts|talk]]) 12:15, 10 November 2012 (EST) |
| | | | |
| − | Link to a specific section of a page with a hash sign. For example, <code><nowiki>[[Dominion#Awards]]</nowiki></code> links to the Awards section of the [[Dominion]] page.
| + | :For some reason I feel like ''Big Money'' should be capitalized but ''engine'' shouldn't. [[User:Ajd|Ajd]] ([[User talk:Ajd|talk]]) 12:52, 10 November 2012 (EST) |
| | + | ::I agree; ''Big Money'' is a name, but engine is just a word. --[[User:Drab Emordnilap|Drab Emordnilap]] ([[User talk:Drab Emordnilap|talk]]) 23:01, 12 November 2012 (EST) |
| | | | |
| − | ===External links=== | + | ====Usernames==== |
| − | External links should usually be collected into a section. Use a descriptive phrase for the text of the link. Do not bait the reader with phrases like “click here”.
| + | What about usernames, like Stef and faust? Some don't capitilise, some do, others have multiple (AdamH, GwinnR). How do we deal with these? Capitilise everything, and stick to the other capital letters? Stick with their choice? --[[User:Hugovj|Hugovj]] ([[User talk:Hugovj|talk]]) 15:58, 28 September 2015 (EDT) |
| | | | |
| − | ===Templates=== | + | ===Internal Links=== |
| − | Make use of the custom Dominion templates when possible. In particular, use the following instead of wikilinks:
| + | *Only use internal links for the first appearance on a page. |
| − | * <code><nowiki>{{Card}}</nowiki></code>, <code><nowiki>{{Event}}</nowiki></code>, <code><nowiki>{{Landmark}}</nowiki></code>, etc for every appearance of a Dominion [[card-shaped thing]]. | + | *If a subsection is sufficiently long, internal links for the first appearance in the subsection can be added, even if it was linked in a previous section. |
| − | * <code><nowiki>{{Set}}</nowiki></code> for every appearance of a Dominion set
| + | |
| | | | |
| − | Use Dominion symbols when referring to those concepts. Avoid using symbols in conjunction with punctuation. For example, use “the value of {{Cost|P}}” instead of “{{Cost|P}}’s value”.
| + | :I feel like card names should always be linked, even if they've appeared on the page previously. Yay, nay? --[[User:Drab Emordnilap|Drab Emordnilap]] ([[User talk:Drab Emordnilap|talk]]) 23:01, 12 November 2012 (EST) |
| − | * {{Cost}}: Use this symbol to refer to amounts of this currency, instead of “coins”, “money”, or “$”. If you need to refer to a general amount of {{Cost}}, you may use {{Cost}} with no value or say “economy”, “money”, etc.
| + | :: I would avoid linking cards when they are being used as verbs: "Throning", "Bishoping", etc. and avoid most linkages of the base-set [[Treasure]] and [[Victory]] cards. But otherwise, yes, link them (using [[Template:Card]], of course). [[User:JesseW|JesseW]] ([[User talk:JesseW|talk]]) 02:51, 17 April 2013 (EDT) |
| − | * {{Cost|P}}: Use this symbol to refer to this currency. Only write out the word {{Card|Potion}} when referring to the card.
| + | |
| − | * {{Debt}}: Use this symbol to refer to amounts of this token resource. Refer to the token as a “Debt token”.
| + | |
| − | * {{VP}}: Use this symbol to victory points and victory point tokens. Do not use “VP”.
| + | |
