N1GP:Style guide: Difference between revisions

From N1GPedia
Line 61: Line 61:
* ❌ Cannon hits '''the opponent''' for 40 damage.
* ❌ Cannon hits '''the opponent''' for 40 damage.
* ✅ Cannon hits '''an enemy''' for 40 damage.
* ✅ Cannon hits '''an enemy''' for 40 damage.
* '''Why:''' Hitting the other person is assault.


* ❌ Recovery 10 heals the '''player''' for 10 HP.
* ❌ Recovery 10 heals the '''player''' for 10 HP.
* ✅ Recovery 10 heals the '''user''' for 10 HP.
* ✅ Recovery 10 heals the '''user''' for 10 HP.
 
* '''Why:''' An enemy using Recovery 10 does not heal the player.
* ❌ Chip Shuffle shuffles chips in the '''user''''s hand.
* ✅ Chip Shuffle shuffles chips in the '''player''''s hand.


* ❌ Area Grab steals a column of tiles from the '''enemy''''s side.
* ❌ Area Grab steals a column of tiles from the '''enemy''''s side.
* ✅ Area Grab steals a column of tiles from the '''opponent''''s side.
* ✅ Area Grab steals a column of tiles from the '''opponent''''s side.
* '''Why:''' Enemies do not always stand on the opponent's tiles.

Revision as of 21:44, 26 October 2022

The style guide is a set of guidelines for writing articles in the N1GP wiki.

StyleGuideHeader.png

This is not intended to be prescriptive and violating it where it makes sense is encouraged. However, in order for content to be easily found and digested by readers, the guidelines here should take precedence.

Naming

Articles should be named in sentence case, unless the title uses proper nouns. All chip, NaviCust part names, Souls, and Crosses are considered proper nouns.

For chips and NaviCust parts, they should be named by the full name of the chip or part. For instance:

  • ❌ BassAnly
  • ❌ BassAnomaly
  • ✅ Bass Anomaly

If a concept exists across multiple games, the name of the article should be proceeded by the game abbreviation in parentheses, e.g. an article for Bass Anomaly for Battle Network 6 should be named Bass Anomaly (BN6). For concepts that only exist in a single game, it is OK to omit the abbreviation, e.g. Tomahawk Cross.

For chips and NaviCust parts in the same family, we try to group them together to avoid duplicating content. For instance, Corn Shot 1/2/3 should be grouped into the Corn Shot chip series, and Attack +1 and Attack MAX should be grouped into the Attack NaviCust part series.

Content

The first line of an article should contain a brief summary of the topic, along with bolded text containing the name of the article as the first phrase in the article, after any articles (e.g. The). For chips and NaviCust parts, they should describe the "obvious" effect of the chip or part.

Any following paragraphs should go into more detail about the topic. You should try to follow the "funnel" technique of writing: more general details should come first, followed by more specific or technical details.

Terminology

We want to strive to keep terminology used across the wiki consistent. If you see anything using one of the other terms, please change it to the standard term. If you notice that the same concept is being referred to by two different terms and isn't in the list below, please add it.

We should also prefer fully-written out names (e.g. "time freeze cancel" over TFC) so terms can be self-explanatory in the context they appear in.

Standard term Other terms Description
drag Effect applied by Wind Racket's impact. Subtypes of drag include small pull, small push, big push. Not to be confused with slide.
flashing Invis, invisible, blinking (MMSF term) Effect applied Invisible/being hit by most chips.
frames i, f, ticks Technically ticks, but frames are an easier concept to understand.
invulnerable invincible, "green" Effect applied by Fanfare or Color Bug.
paralyzed (status effect) paralysis, paralyzation, stun Effect applied by White Capsule.
slide Effect applied by Wind or Fan gusts. Not to be confused with drag.
time freeze cancel cut in (official), TFC Occurs when a time-freezing chip is interrupted by a different time-freezing chip.
time-freezing dimming (official) Time freeze effect caused by e.g. Navi chips.
White Capsule whitepill based and whitepilled

Players, opponents, users, and enemies

  • Player: Refers to you, the person.
  • Opponent: Refers to not you, the other person.
  • User: Refers to the Navi using the chip.
  • Enemy: Refers to the entity being targeted by a chip.

Examples:

  • ❌ Cannon hits the opponent for 40 damage.
  • ✅ Cannon hits an enemy for 40 damage.
  • Why: Hitting the other person is assault.
  • ❌ Recovery 10 heals the player for 10 HP.
  • ✅ Recovery 10 heals the user for 10 HP.
  • Why: An enemy using Recovery 10 does not heal the player.
  • ❌ Area Grab steals a column of tiles from the enemy's side.
  • ✅ Area Grab steals a column of tiles from the opponent's side.
  • Why: Enemies do not always stand on the opponent's tiles.