Community Style Guidelines: Difference between revisions

From Victory Belles Community Wiki
Jump to navigation Jump to search
fandomVB>Sovereign
(Drastic chop-down since Cargo removed a lot of need for anyone to manually enter data.)
 
(29 intermediate revisions by 2 users not shown)
Line 1: Line 1:
This is intended to be an overview of community-driven stylistic decisions for the Victory Belles wiki.  As items arise, they will be added.   
This is intended to be an overview of community-driven stylistic decisions for the Victory Belles wiki.  As items arise, they will be added.   


==Accents and Language Marks==
'''These guidelines will undergo significant revisions as {{SITENAME}} is''' '''currently in the process of moving to an independently-hosted MediaWiki instead of Fandom, granting the community more freedom in how the site is built.''' 


Where possible, a Belle/ship name should retain any accents or other markings of its native language.  For example, [[Algérie]] retains its accented letter.
==Abbreviations and Shortenings==
For consistency, please observe the following abbreviations/shortenings since more than one valid option exists.


==Belle Detail Pages==
* World War 2 - '''WW2'''
To keep large data-dumps off the main Belle pages, each Belle has (or will have) a "DetailsPage" that contains her stock configuration, information about vestures, and default armor statistics.  Such pages are very legible on mobile devices despite the large amount of data presented.  [[Dunkerque/DetailsPage|Dunkerque]] has an in-progress (circa September 2021) example of a details page. 


Add the following code to any Belle without a detail page.  Generally this should be placed after the Gameplay Information section.  This adds a box with an automatically-generated link which invokes a pre-loaded template to build out the Belle's detail page.  The editor then only needs to fill all known fields.
In addition, the following should not be shortened.
<pre>
{{NoBelleDetailsPage}}
</pre>


=== Empty Categories ===
* When referring to experience points, the word should be written out, rather than abbreviated as "XP" (though "points" need not be included when "experience" clearly refers to the in-game numerical system denoting a Belle's level).
Some Belles have nothing ''at all'' in a certain category--for instance some destroyers have no secondary battery, most battleships do not equip torpedoes.  See [[Victory Belles Wikia:NoStockPage|this list]] of templates for use on Belle detail pages in these circumstances.


==Belle Name, Ship Name==
==Accents and Language Marks==
 
Where possible, a Belle/ship name should retain any accents or other markings of its native language.  For example, [[Algérie]] retains its accented letter.


===Wiki Page===
===Wiki Page===
The current (September 2021) consensus is that the ''page'' should be the name of the ship the Belle represents without any national modifiers (like "USS") or hull designators (like "CA").  Several US Belle pages were moved to a namespace with only their name in September 2021.
A Belle page should be the name of the ship the Belle represents without any national modifiers (like "USS") or hull designators (like "CA").  Use hull numbers only if needed, which is expected to be rare as described for Wasp below.  Several United States Belle pages were moved to a namespace with only their name in September 2021.


Want to help move pages? [[Special:PrefixIndex/USS|Click here]] for a list of ships with the USS prefix that need moving''Italicized'' links are just redirects--those can be ignored.
Should a reader stumble across any Belle pages with modifiers/designators, feel free to move them to "just the name." No redirects are required, and will be deleted if found as they serve no purpose.


===Character===
===Character===
The current (September 2021) consensus is to refer to the Belle in the same way as the page.
Refer to the Belle in the same way as the page.


"Maury is one of the starting Belles available to the United States faction."
:"[[Maury]] is one of the starting Belles available to the United States faction."


===Ship===
===Ship===
The current (September 2021) consensus is to refer to the historical ship using its national designator ("USS," "HMS," etc.) and hull number if needed (in cases of multiple ships sharing the same name).
Refer to the historical ship using its national designator ("USS," "HMS," etc.) and hull number if needed (in cases of multiple ships sharing the same name such as aircraft carrier USS Wasp--CV-7 and CV-18).


There is no consensus on whether historical ship names should be ''italicized'' when used in the wiki.  When a consensus is reached, this page shall be updated.
There is no consensus on whether historical ship names should be ''italicized'' when used in the wiki.  When a consensus is reached, this page shall be updated.


"USS Maury (DD-401) was one of the most decorated ships of World War 2."
:"USS Maury (DD-401) was one of the most decorated ships of WW2."


==Capitalization==
==Capitalization==


Due to community prevalence (such as on Discord, and existing content on this and another inactive wiki) and staff usage, both "Belle" and "Morgana" should be capitalized/treated as proper nouns.   
Due to community prevalence (such as on Discord, and existing content on this and another inactive wiki) and staff usage, both "Belle" and "Morgana" should be treated as proper nouns.   


Referencing the wiki itself ("On this wiki...") should not be capitalized.
Referencing the wiki itself ("On this wiki...") should not be capitalized.
Line 43: Line 41:
There is no current (September 2021) consensus on capitalization of specific game terms.  For example, when discussing a Belle's main battery, should it be written "Battery I" or "battery I?"  Should nouns like "vestures" be capitalized?
There is no current (September 2021) consensus on capitalization of specific game terms.  For example, when discussing a Belle's main battery, should it be written "Battery I" or "battery I?"  Should nouns like "vestures" be capitalized?


==Empty Values==
Two-word ship type categories (such as [[:Category:Light Cruiser|Light Cruiser]]) have both words capitalized.
When a value for a named line in an existing information box/table is not included, it will automatically populate with ''Unknown.''
 
== Equipment==
 
Equipment names in Victory Belles can be very complex and lengthy, with a single digit denoting two different pieces of otherwise-similar equipment.
 
== Links==
'''Bare links are bad!'''  Even in trivia sections!  (Like dumping a link to the ship's Wikipedia article.)  The only place bare links won't look ugly is in reference sections at the bottom of pages. 
 
It is recommended to link WikiWords (such as "Belle") on their first use in an article.


Text for an empty value should follow these guidelines.
Most questions about creating MediaWiki links can be answered in [https://www.mediawiki.org/wiki/Help:Links this article].


*If the line can be filled in the future, but the information that would populate it is not currently available, ''don't type anything into the template for that field!'' See the below template, which would be an ''Unknown'' Belle.<p>[[File:empty_template.JPG|300px]][[File:unknown_belle.JPG|300px]]</p>For example, a Belle with a voice whose actress has not been credited publicly at time of page creation would have her voice actress listed as ''Unknown''.
==Maps==
*"None" if the line can be filled, but isn't.  For example, a Belle whose stock main battery contains an open but empty RDF slot should list RDF as "None," and an unvoiced Belle should list her voice actress as "None."
A map page name should just be the name of the map without HQ levels or other modifiers. Those details are already contained on the page, and the infobox title is pulled from the page.
* "N/A" if the line applies to ''other'' uses of the table (as part of the template), but the line is not valid for the table in question.  For example, a Belle whose stock main battery configuration has a locked RDF slot would list this as "N/A."


== Equipment==
Map pages should contain an image of the map as viewed from a Campaign.  At present (October 2021) obtaining "clean" images of maps without player ship icons, node highlights, or scouting ranges is not easy.  It is expected until some method is standardized (or map images are provided by the developers--unlikely) that many map articles will use "good enough" placeholder images.


Equipment names in Victory Belles can be very complex and lengthy, with a single digit denoting two different pieces of otherwise-similar equipment.
Infoboxes with [[Template:MapInfobox/doc#With_Two_Images|two images]] are preferred--first the map, then locations of [[Morgana]] spawns.


===Wiki Page ===
For consistency when describing available map resources, treat them all as proper nouns.  These resources are, from left to right in the Victory Belles interface: Personnel, Fuel, Ammo, Steel, and Rare Materials.  The others, Prestige and Diplomacy, are not available as Cruise drops.
No consensus yet exists (September 2021) as to how to name pages for equipment.


==Leading Zeroes==
Known map Limits are No Torpedoes and No Aircraft, as demonstrated by the red icons on the right below.
If the game uses a leading zero on a displayed decimal value (such as armor quality), the wiki should retain the leading zero when listing it.
[[File:map_limits.png|400px]]


== Links==
Like Belle pages, map pages push lengthy lists onto a subpageAll map pages have "MapName/BellesOfInterest" for vesture drops, and maps with bases also possess "MapName/MapBaseTable" which details the nation(s) whose base(s) are present on the map.
'''Bare links are bad!'''  Even in trivia sections!  (Like dumping a link to the ship's Wikipedia article.) The only place bare links won't look ugly is in reference sections at the bottom of pages.  [https://www.mediawiki.org/wiki/Help:Links Read up] on how to create MediaWiki links if you have questions.


==Mobile First==
==Mobile First==
Line 75: Line 78:
*Consider moving ''extremely'' long tables of data (such as statistics) to a separate statistics page for the item in question.  Belle detail pages have a preloaded template.
*Consider moving ''extremely'' long tables of data (such as statistics) to a separate statistics page for the item in question.  Belle detail pages have a preloaded template.


==Pages==
==Numbers==
Pages should be derived from a template if at all possibleThis helps standardize the wiki's appearance.
===Decimals===
If the game uses a decimal, use the period, do not switch to a comma.
===Handling Zeroes===
If the game uses a leading zero on a displayed decimal value (such as armor quality), the wiki should retain the leading zero when listing it.   
If the game uses a trailing zero on a displayed decimal value (such as performance), the wiki should retain the trailing zero when listing it.
=== Thousands Separators ===
The separator for thousands should be a comma. 


Spaces should be replaced with underscores, like this page (Community_Style_Guide), rather than PascalCasingPageNames because they are easier to read in the URL. Note that the opposite is true with templates, because having a ton of underscores in a template name is irritating when writing pages. Templates are invisible to the user, page names aren't.
:''Test Belle has 2,500 hitpoints at level 1.''
:''Test Belle's historical ship displaced 25,000 tons.''


This game contains a large amount of data that needs to be presented in a unified, mobile-friendly formatTables allow corralling said data while maintaining a mobile-friendly experience.
==Pages==
All Belle main pages are template/Cargo driven and require very little human interaction[[Template:NewBellePage/doc|Documentation]] explains what options an editor might need to set.


Minimize image usage on main pages. For example, if a Belle receives a "skins" page, go nuts with images there, but not on her main page!
==Player/Reader References==
If an article must reference players of the game generally, readers of the wiki, or both, avoid using "you."
:''Players should be aware of their flagship's tactics before a battle.''
:''If a reader has opinions on this Belle, please add them to the talk page.''


==Speculative Belles==
==Speculative Belles==
Adding Belles whose presence has not been confirmed by either the developers or users finding said Belle in-game is not allowed.  Yes, we know a "shipgirl" game will probably ''eventually'' get Yamato, but she's not present right now so don't add her (or anyone else) based on guessing.
Adding Belles whose presence has not been confirmed by either the developers or users finding said Belle in-game is not allowed.  Yes, we know a "shipgirl" game will probably ''eventually'' get Yamato, but she's not present right now so don't add her (or anyone else) based on guessing.
== Table/Information Box==
===Table vs. Information Box===
The Infobox is a stock class on Fandom, and is restricted to loading on the right.  The Belle information box is the only (September 2021) current example.
Almost all the templates for tables on Belle "detail pages" are two-column setups with optional column headers and an optional title overall.  These work well on mobile and don't look horrible on desktop.

Latest revision as of 13:05, 9 May 2023

This is intended to be an overview of community-driven stylistic decisions for the Victory Belles wiki. As items arise, they will be added.

These guidelines will undergo significant revisions as Victory Belles Community Wiki is currently in the process of moving to an independently-hosted MediaWiki instead of Fandom, granting the community more freedom in how the site is built.

Abbreviations and Shortenings[edit | edit source]

For consistency, please observe the following abbreviations/shortenings since more than one valid option exists.

  • World War 2 - WW2

In addition, the following should not be shortened.

  • When referring to experience points, the word should be written out, rather than abbreviated as "XP" (though "points" need not be included when "experience" clearly refers to the in-game numerical system denoting a Belle's level).

Accents and Language Marks[edit | edit source]

Where possible, a Belle/ship name should retain any accents or other markings of its native language. For example, Algérie retains its accented letter.

Wiki Page[edit | edit source]

A Belle page should be the name of the ship the Belle represents without any national modifiers (like "USS") or hull designators (like "CA"). Use hull numbers only if needed, which is expected to be rare as described for Wasp below. Several United States Belle pages were moved to a namespace with only their name in September 2021.

Should a reader stumble across any Belle pages with modifiers/designators, feel free to move them to "just the name." No redirects are required, and will be deleted if found as they serve no purpose.

Character[edit | edit source]

Refer to the Belle in the same way as the page.

"Maury is one of the starting Belles available to the United States faction."

Ship[edit | edit source]

Refer to the historical ship using its national designator ("USS," "HMS," etc.) and hull number if needed (in cases of multiple ships sharing the same name such as aircraft carrier USS Wasp--CV-7 and CV-18).

There is no consensus on whether historical ship names should be italicized when used in the wiki. When a consensus is reached, this page shall be updated.

"USS Maury (DD-401) was one of the most decorated ships of WW2."

Capitalization[edit | edit source]

Due to community prevalence (such as on Discord, and existing content on this and another inactive wiki) and staff usage, both "Belle" and "Morgana" should be treated as proper nouns.

Referencing the wiki itself ("On this wiki...") should not be capitalized.

There is no current (September 2021) consensus on capitalization of specific game terms. For example, when discussing a Belle's main battery, should it be written "Battery I" or "battery I?" Should nouns like "vestures" be capitalized?

Two-word ship type categories (such as Light Cruiser) have both words capitalized.

Equipment[edit | edit source]

Equipment names in Victory Belles can be very complex and lengthy, with a single digit denoting two different pieces of otherwise-similar equipment.

Links[edit | edit source]

Bare links are bad! Even in trivia sections! (Like dumping a link to the ship's Wikipedia article.) The only place bare links won't look ugly is in reference sections at the bottom of pages.

It is recommended to link WikiWords (such as "Belle") on their first use in an article.

Most questions about creating MediaWiki links can be answered in this article.

Maps[edit | edit source]

A map page name should just be the name of the map without HQ levels or other modifiers. Those details are already contained on the page, and the infobox title is pulled from the page.

Map pages should contain an image of the map as viewed from a Campaign. At present (October 2021) obtaining "clean" images of maps without player ship icons, node highlights, or scouting ranges is not easy. It is expected until some method is standardized (or map images are provided by the developers--unlikely) that many map articles will use "good enough" placeholder images.

Infoboxes with two images are preferred--first the map, then locations of Morganas spawns.

For consistency when describing available map resources, treat them all as proper nouns. These resources are, from left to right in the Victory Belles interface: Personnel, Fuel, Ammo, Steel, and Rare Materials. The others, Prestige and Diplomacy, are not available as Cruise drops.

Known map Limits are No Torpedoes and No Aircraft, as demonstrated by the red icons on the right below. File:Map limits.png

Like Belle pages, map pages push lengthy lists onto a subpage. All map pages have "MapName/BellesOfInterest" for vesture drops, and maps with bases also possess "MapName/MapBaseTable" which details the nation(s) whose base(s) are present on the map.

Mobile First[edit | edit source]

As a game primarily directed at mobile users, this wiki should strive to present information in a way that is optimized for mobile devices.

  • Think vertical.
  • Avoid horizontal scrolling, even a little.
  • Minimize image use outside of tutorials on page-writing like this one (which is an activity best performed on a computer).
  • Prefer more rows, fewer columns (templates tend to encourage a two-column layout which fits well on mobile).
  • Consider moving extremely long tables of data (such as statistics) to a separate statistics page for the item in question. Belle detail pages have a preloaded template.

Numbers[edit | edit source]

Decimals[edit | edit source]

If the game uses a decimal, use the period, do not switch to a comma.

Handling Zeroes[edit | edit source]

If the game uses a leading zero on a displayed decimal value (such as armor quality), the wiki should retain the leading zero when listing it. If the game uses a trailing zero on a displayed decimal value (such as performance), the wiki should retain the trailing zero when listing it.

Thousands Separators[edit | edit source]

The separator for thousands should be a comma.

Test Belle has 2,500 hitpoints at level 1.
Test Belle's historical ship displaced 25,000 tons.

Pages[edit | edit source]

All Belle main pages are template/Cargo driven and require very little human interaction. Documentation explains what options an editor might need to set.

Player/Reader References[edit | edit source]

If an article must reference players of the game generally, readers of the wiki, or both, avoid using "you."

Players should be aware of their flagship's tactics before a battle.
If a reader has opinions on this Belle, please add them to the talk page.

Speculative Belles[edit | edit source]

Adding Belles whose presence has not been confirmed by either the developers or users finding said Belle in-game is not allowed. Yes, we know a "shipgirl" game will probably eventually get Yamato, but she's not present right now so don't add her (or anyone else) based on guessing.