Help:Manual of Style

From Dustloop Wiki
Jump to navigation Jump to search

The Manual of Style (MoS or MOS) is the style manual for all Dustloop articles. This primary page is supported by further Writing Character Pages and Writing System Explanations. If any contradiction arises, this page has precedence. Failing to follow this document is considered a violation of the user Policy. In the majority of situations no action will be taken against a user who fails to follow this guide because the Bureaucrat Team recognizes that mistakes happen, and not every user is confident and comfortable with editing wikis. With that made clear, the team does still reserve the right to remove user's edit access if that user makes egregious and intentional violations of this page.

Retaining Existing Styles

Sometimes the MoS provides more than one acceptable style or gives no specific guidance. The Moderation Team has expressed the principle that "Format is flexible and individual users can push innovation". This does not mean anything goes. If you believe an alternative style would be more appropriate for a particular section, please discuss it in the Dustloop Discord.

Edit-warring over style is never acceptable.

General Writing Style

Dustloop aims at being an impartial, community driven source of information and education. In order to achieve that, articles need to be written in a manner conducive to maintaining trust, professionalism, and respect. Dustloop would also like to recognize that a significant audience of the site does not speak English as their first language, and so the administration of the site asks that sentences are kept relatively simple when possible.

As a general rule of thumb:

  • Write in the 3rd person.
  • Avoid excessively emotive language when possible. (eg: "insanely oppressive offense and abysmally awful defense")
  • Try to be impartial and objective.

To add to that point, Dustloop needs to be written agnostic to the skill of the reader. Do not assume a particular level of reader competence so that the largest audience reasonably possible. An easy way to achieve this is to stick to the descriptive nature of what the character can do as opposed to what the player can do. Instead of "you can block while in the air", write "X Character can block while in the air".

Casual language and inside jokes are acceptable so long as they are kept in moderation.

English, Please!

Dustloop is an English website. Until the day comes that we have the resources, staff, and volunteers to set up an infrastructure for multiple languages, that will continue to be the case. Therefore, the wiki should remain in English.

If there's a borrow word that is not normally a part of the English language, such as "okizeme", then it should be used with a tooltip the first time that it appears on the page in order to explain it to the reader. Terms like this which are commonly used on the wiki are included in the {{Keyword}} template. Otherwise, use the {{Tt}} template. For example:

This character has a big emphasis on {{Keyword|okizeme}}. They have a good matchup against {{Tt|George Bush|Some guy from America}}.

This character has a big emphasis on OkizemeFrom Japanese "起き攻め". Attacking an opponent about to wake up, usually with meaty attacks or mixups.. They have a good matchup against George BushSome guy from America.

Do not use non-English text in the

Why Using Non-English Text In Headers Causes Problems

I'm typing this here because I wanted to include an example with my writeup, and I don't want to duplicate text between here and Discord chat.

Links to sections are generated based on the entire contents of the section header. Adding additional text to a section header that you plan to link to will have effects ranging from making the author add extra words when writing their link, or need to find and copy paste some wacky hyperlinks that aren't easily remembered.

Using non-English Characters in Section Header

Using non-English characters in a section header results in a generated section link with some wacky codes to represent the non-English characters. These are unreasonable for an author to remember, so they will have to find them and copy-paste them when writing a link in an article. Click the "Tell Me More" button for an in depth explanation and breakdown.

On Strive Anji's page the header Kou / 紅 generates the following link GGST/Anji_Mito#Kou_.2F_.E7.B4.85

Another problem with using non-English characters in your link is that a direct copy-paste of the section header does not generate a valid link to the section.

Although the section header is Kou / 紅, the following mediawiki link, GGST/Anji_Mito/Kou / 紅, is not valid for two reasons.

  1. the link has a / character, which is not valid. It makes the link think you are pointing to a sub page
  2. the non-English characters are non recognized, and instead their code needs to be used instead.

Using Special Characters in Section headers


Special characters sometimes behave similarly to non-English characters and generate wacky links when used in section headers. A famous example of this one is Jack-O'.

If you section was named Jack-O', you could not use that as the link. Instead, you would have to use Jack-O%27

Sneaky Broken Links


When you add stuff to the section header, you make it harder to remember what needs to be in the header to work. Let's give an example.

I want to link to Kliff's move "Limb Sever". My first instinct is to write out the link as game/character#move - GGACR/Kliff Undersn#Limb Sever. This actually doesn't work because somebody has appended the Japanese name to the end of the section header. Yet, the link will still show up as blue giving the author the impression that the link is valid.

When a section link has a correct page, but an incorrect section, the link shows as blue, but simply takes the user to the top of the page as opposed to the section they desired. Because somebody has added to the section header, I would instead have to write the link to this section like so GGACR/Kliff_Undersn#Limb_Severer_.28Shishi_Otoshi.29 to get the functioning link.

Color Coding and highlighting

If you've used the site for some time you will have noticed text with colors such as this: c.S > 6K, using the {{clr}} template. This is a technique authors use on the site to make numpad more accessible to beginner players by relating the colors of the inputs with the colors used for button prompts in game. Color coding can pose problems for users with color deficient vision. Please be conservative and do not add color coding outside of recommended use cases in this list.

Things you are encouraged to color code:

  • Move inputs (eg: c.S, j.236A, etc)
  • Tags (eg: BUFF, REWORKED, etc)
  • Difficulty ratings for combo tables (eg: Easy, Hard)

Acceptable edge cases for color coding:

  • Net Change values for combo tables (eg: -10)

Things you should not color code:

  • Move names (eg: Potemkin Buster, Lullaby Fist)
  • Test you wish to emphasize
Hot Links on standard text will be made blue in order to indicate to the user that the text is, in fact, a clickable link. Link colors do not fall under the guidelines listed above.

Pronouns and Gendered Language

We recommend an approach adopted from the APA Style.

Use "They/Their/Them" When:

  • The gender of the subject is irrelevant to the point being discussed
  • The gender of the subject is unknown
  • There are multiple subjects with differing genders

Use Gender Pronouns When:

  • The text needs the additional specification of gender to be clear
  • The gender of the subject is known and unambiguous in primary sources
Because there is a significant amount of content which already exists on the wiki and uses gendered pronouns to refer to characters, we do not recommend changing the existing pronoun usage unless it improves the quality of the article.

Jokes and Captions

JokeCaptionCheatSheet.png

Dustloop has a long history of having joke captions under the images for moves, and sometimes even in the overviews. Some of these captions are genuinely funny and considered a welcome and fun part of the Dustloop experience.

The current stance of the Bureaucrat Team is that we do not want to do away with joke captions entirely, and would still like to grant them some good will, but joke captions will be treated with greater scrutiny in the future, and less of them will be allowed per-page. There is no hard limit, and will be handled case-by-case. Move captions should be on-topic. Personal discretion applies here, so please operate on the honor system.

Criteria for welcome jokes and captions:

  • Jokes that are relevant to the character as they appear in game
  • Explanations of what the moves do
  • Comedic or lighthearted references to how the move is used
  • Comedic references to the primary source material (the game itself, not anime or manga which it is based on)
  • References to the metagame
  • Anything that attempts to be informative or educational

Examples of unwelcome jokes and captions:

  • Inside Jokes
  • References/Quotes from YouTube/Twitter/social media
  • References/Quotes to content not immediately related to the source material
  • Memes that you would expect to find on Tik-Tok (YEET, etc)
  • Political content or hateful content
The purpose of the site is not to be a platform for jokes, but instead to be informative and helpful.

Character Overviews

Character Overview Pages are the most commonly read articles on the entirety of Dustloop. As such, these articles will be held to the highest standard.

Many readers do not have a long attention span, so get to the point. Be descriptive, detailed, and accurate, but avoid wasting time with flowery language. Overviews need to cover a lot of information in a relatively compact space so it is recommended that editors avoid making excessive use of adjectives fluff phrases.

The overview for a given character should give a reader a basic understanding of what the character can do, what the character's gameplan is, crucial flaws, and key strengths are. The latter two points can be carried by the pros/cons table in the majority of situations, but it is sometimes appropriate to mention things in greater detail within the overview. A reader should walk away from an overview with a baseline understanding of how a character players at a macro scale.

Lore Blurbs

Lore blurbs are optional fields in the overview for a character designed to communicate some information about the character outside of gameplay. Whenever possible, these blurbs should be taken word-for-word from official sources. An example of this would be Granblue Fantasy Versus. Each character, at the time of writing this article, has an official lore description available on their website. In the event that user wishes to write an unofficial lore summary, the summary should be kept short and simple. Four (4) to Six (6) sentences should be considered a safe upper limit for the length of the lore blurb.

If the quote field is used, it should either use quotes from official sources, such as Arc System Works' websites, or quotes which are directly verifiable within their respective game.

Playstyle Summaries

Playstyle summaries are single sentence summaries of their respective character's overview. These do not need to be incredibly detailed and are meant to be read at a glance. The template will force every playstyle summary to start with an icon of the character and the character's name.

Strengths and Weaknesses Tables

Strengths and Weaknesses tables, also known as the pros/cons section, are potentially very contentious and can be damaging to the site's reputation when handled without care. As such, these sections should be collaborative efforts which are frequently cross referenced and verified. Below is a non-exhaustive list of guidelines to follow when editing this section. The Bureaucrat team reserves the right to make rulings on these sections on a per-case basis.

  • Begin every bullet point with a bolded summary of the bullet point, followed by an un-bolded colon.
  • Try to Keep each bullet point to a maximum of 4 lines of text.
  • Be specific. If a point depends on a specific set of moves or situations, enumerate them.
  • Be fair. It is natural to want to emphasize how weak a character's option may be, or how strong it may be. Keep these lists metered and avoid making absolute statements as to what is best and worst in the game.

This section is one of the most scrutinized by outside eyes, and as such it should contain the absolute bare minimum of jokes.

What Constitutes a pro and a con?

This is constantly up for debate, and sometimes people's opinions will change with time. The goal with these lists should be to inform readers as to the following traits:

  • What does this character excel at?
  • What can I abuse as this character to gain an advantage?
  • What flaws do I have to play around with this character?
  • What about my character can opposing characters exploit to gain an advantage over me?
A note about Execution

High execution should only be a weakness if the character loses something significant from execution mistakes. Think through these examples:

What does the character lose by dropping a hard combo, and how integral is that to playing properly?

Example A) Sol

Sol drops a Sidewinder. The opponent techs out at the top of the screen.
Does he die for it? No.
Does he have to play neutral again? Yes
Is Sol's neutral good? Compared to the majority of the cast, No

So is solid execution a big deal? It's not the worst thing, but it forces him to go back to instances where he's inherently at a disadvantage. It's still important to consider.

Example B) Johnny

Johnny drops a Killer Joker FRC, or an Enkasu, or a Tk Ensenga.

Does he die for it? Possibly
Does he have to play neutral again? You betcha
Is Johnny's neutral good? It can be, but he eats shit for a single whiff/getting low profile'd

Is all of this important to playing the character? It's pretty important, yes. Probably comparable, if not worse than Sol.

Example C) Chipp

Chipp flubs a j.2K FDC/Instant Air Alpha/basic IAD string

Does he die for it? Very much so
Does he have to play neutral again? Can't play neutral if you're dead
Is Chipp's neutral good? Unless you're on point, you're gonna have to jump around and if you get touched, you're dead. His buttons are fantastic but most of them don't lead to a proper knockdown or any solid damage.

Is this vital to playing Chipp? Absolutely. A single drop spells death, meaning you either commit hard to the actual damage and make certain you have it, or you commit to small hits left and right, and you'd better not mess those up either.

Given these examples, Example A is not a con, Example B can be listed as a footnote to the table (by adding the |footnote= argument with an explanation), and Example C is a con and can be listed in the right column of the table.

Move Lists

Move lists leave freedom to the community to act as a guide in addition to a fact source. Every move contains a description area where editors can give advice on how a move can be used, the important drawbacks of a move, and so forth. Specific details on how to style these sections can be found on Writing Character Pages, but in general this section is open to whatever people feel is appropriate.


Bad Moves VS Situational Moves

Red Hail on Venom's page. The move carries many flaws, costs meter, and is hard to use in the first place. Yet, there are niche ways to use it.
A good description for a BAD move.
Punisher Drive on SSB Gogeta's page. The move is described as limited and reactable with low reward, but useful in neutral and in TOD combos.
A good description of a SITUATIONAL move.

Sometimes characters have moves that are questionably helpful. In some cases, the community can come to the conclusion that the move is more risk than it's worth, and advise players to avoid using said move in most circumstances. In others, it's helpful in enough scenarios where the move is simply referred to as "situational." Despite this, it's rather common for writers to list many moves with considerable downsides as simply being situational, which is ill-advised due to its vague narrative, dishonesty, confusion to new players and potentially contradicting competitive expertise.

Ask yourself the following questions if you can't decide what a move should be described as:

  • Does the move only become helpful in few, select situations?
  • Does the move have reactable startup, punishable recovery, avoidable hitboxes, or otherwise high risk characteristics?
  • Does the move give low reward for landing it?
  • Does the move have a cost such as meter, cooldowns, health, or a character-specific resource?
  • Does the move replace other moves? Is it possible to revert the replacement in the middle of the match?
  • Does the move have an easy obvious counter, reducing the attack to a knowledge check?

There are also three simpler questions, but these are prone to more debate so handle these with care or use them as tiebreakers.

  • Will top level players, character discords, or the community at large advise against using the move?
  • Does the character have an objectively better choice for the same situation?
  • Is this move so bad you will simply be killed immediately for using it no matter what, or invariably puts you in a worse situation regardless of success? This will be discussed again later.

If you find that too many of these can be checked off, you are likely staring at a bad move, not a situational one. It's important to differentiate the two, as you don't want readers to believe that a move is better or worse than it really is, but also don't want readers to believe that a helpful move limited to certain scenarios is bad simply because it's not all-purpose. Likewise, just because a move is reactable or has limited range does not make it bad on its own, unless these flaws are so pronounced it will never realistically be feasible to use the move.

There are rare circumstances where moves are so bad, there are no upsides. Describing these moves as "situational" is wrong.
Please exercise caution when describing certain moves as "bad" in a hyperbolic sense, unless it truly is deserving of such harsh criticism.

Using Move Names or Inputs

Depending on the context, both move names and inputs can be appropriately used, and both come with advantages and disadvantages. Some players know moves by their inputs, other by their names. Here are some things you can use to reduce confusion and help both groups of players.

The first time a move is mentioned in a section other than its own, make the text into a hot link to that move's section. Alternatively, use the MiniMoveCard template to create a tooltip that gives an image and frame data of that move.

Examples

Section Hot Link

[[GGACR/Venom#2P|2P]] primarily sees use as a ball launcher for low speed, low height balls, but it also sees situational use as a low commitment way to stop opponents from dashing in point blank for a free pressure reset.

2P primarily sees use as a ball launcher for low speed, low height balls, but it also sees situational use as a low commitment way to stop opponents from dashing in point blank for a free pressure reset.

Mini Move Card

<div>
{{MiniMoveCard|game=GGACR|chara=Venom|input=2P}} primarily sees use as a ball launcher for low speed, low height balls, but it also sees situational use as a low commitment way to stop opponents from dashing in point blank for a free pressure reset.
</div>
2P
GGAC Venom 2P.png
Guard:
Mid
Startup:
7
Recovery:
10
Advantage:
-4
primarily sees use as a ball launcher for low speed, low height balls, but it also sees situational use as a low commitment way to stop opponents from dashing in point blank for a free pressure reset.
MiniMoveCard is special and can only be used within a <div> container. Any template that creates a div automatically also works for this purpose. See the above example.

Fluff Features For Wiki Writing

Dustloop includes a number of templates which we have created for the sake of making articles more engaging to read and more visually interesting. These templates are completely optional, and can be used when you want.

Character Labels

Character Labels add a visual element to your article which can make your text easier to skim read, and more accessible to beginner players who do not know the characters by name yet. Because this template draws the reader's attention to a high degree we recommend only using them the first time you mention a given character in an article. Below is an example of how it can be used in the context of a writeup.

<div>
{{Character Label|GGACR|Sol Badguy|label=Sol}}'s {{MiniMoveCard|game=GGACR|chara=Sol Badguy|input=214S|label=Grand Viper}} is able to low profile your zoning tools and punish you with a full combo. Be wary of this when playing neutral.
</div>
GGACR Sol Badguy Icon.png Sol's Grand Viper
GGAC Sol 214S.png
Guard:
Lowx7, Mid
Startup:
17
Recovery:
37
Advantage:
-21
is able to low profile your zoning tools and punish you with a full combo. Be wary of this when playing neutral.