Stalburg Wiki:Manual of Style: Difference between revisions

m
no edit summary
mNo edit summary
mNo edit summary
 
(5 intermediate revisions by the same user not shown)
Line 1: Line 1:
==Writing style==
==Writing style==
* Content of articles should be written in an neutral, technical, descriptive and precise language, similar to style of writing found in historical documentation, scientific documentation, reports, educational books, technical documentations and manuals.
* Content of articles should be written in an neutral, technical, descriptive and precise language, similar to a style of writing found in historical documentation, scientific documentation, reports, educational books, technical documentations and manuals.
** Informal language, especially a one where the editor loosely collects thoughts, should be avoided. It is not a fanfic, a poetry or a stream of loose thoughts, nor should it use first personal perspective, to use terms like "We don't know a lot about (...)", "We collect/visit/are told (...)", "Maybe it is (...)", etc.
** Informal language, especially a one where the editor loosely collects thoughts, should be avoided. It is not a fanfic, a poetry or a stream of loose thoughts, nor should it use a first person perspective, to use terms like "We don't know a lot about (...)", "We collect/visit/are told (...)", "Maybe it is (...)", etc.
** Despite a technical manner, the articles should not be only limited to simple sentences, and if properly utilised and not overused, complex sentences are permitted and in many cases might be more desireable over simple sentences, where otherwise two separate simple sentences that have an continuity established between them might be easier to read and understand.
** Despite a technical manner, the articles should not be only limited to simple sentences, and if properly utilised and not overused, complex sentences are permitted and in many cases might be more desireable over simple sentences, where otherwise two separate simple sentences that have an continuity established between them might be easier to read and understand.
* Articles should not contain any speculations or theories, if a part of described content requires an interpretation to be performed to write an article about it (for example when a story line is pieced together from several disconnected documents), it should be clearly stated this is in fact an possible interpretation of connected facts and logic, using such terms as "It is possible, that (...)", "It is implied, that (...)", "It was established, that (...)", "It is unknown, if (...)", etc. Addition of a caption of sorts of "Unconfirmed" next to the content in quest, does not justify existence of speculation in the article in the first place.
* Articles should not contain any speculations or theories, if a part of described content requires an interpretation to be performed to write an article about it (for example when a story line is pieced together from several disconnected documents), it should be clearly stated this is in fact an possible interpretation of connected facts and logic, using such terms as "It is possible, that (...)", "It is implied, that (...)", "It was established, that (...)", "It is unknown, if (...)", etc. Addition of a caption of sorts of "Unconfirmed" next to the content in question, does not justify existence of speculation in the article in the first place.
* Articles should be kept consistent with the usage of proper names, and if one item is known under several names, one primary name should be choosen for the article page to refer to that item, with an possibility of shortened name used interchangeably. For instance a location is known under several names of the "Pine Fell Pumping Station", "Pine Fell Water Plant" and "Hammer Valley Pumping Station", in the reoccuring mentions of the name within the article, it should be settled on the primary name, like "(the) Pine Fell Pumping Station" and the shortened name of "(the) pumping station", that are referred in the whole page; the wiki article '''''should not''''' interchangeably use all three main names throughout when referencing the item.
* Articles should be kept consistent with the usage of proper names, and if one item is known under several names, one primary name should be choosen for the article page to refer to that item, with an possibility of shortened name used interchangeably. For example, a location is known under several names of the "Pine Fell Pumping Station", "Pine Fell Water Plant" and "Hammer Valley Pumping Station", in the reoccuring mentions of the name within the article, it should be settled on the primary name, like "(the) Pine Fell Pumping Station" and the shortened name of "(the) pumping station", that are referred in the whole page; the wiki article '''''should not''''' interchangeably use all three main names throughout when referencing the item.
* Refrain from using shortened forms of modal verbs, for example: use "do not" instead of "don't, "cannot" instead of "can't", "it is" instead of "it's", etc.
* Refrain from using shortened forms of modal verbs, for example: use "do not" instead of "don't, "cannot" instead of "can't", "it is" instead of "it's", etc.
* Articles describing game mechanics should use third person perspetive, describing ''a player'' and how they interact with various features, mechanics and game elements, and vice versa, on how these elements interact with ''a player''.
* Articles describing game mechanics should use third person perspetive, describing ''a player'' and how they interact with various features, mechanics and game elements, and vice versa, on how these elements interact with ''a player''.
** Articles describing walkthroughs, or being any other sorts of a guide, should use second person perspective, dictating clear and simple instructions to the player. Tips sections can be made in both second or third person perspective, however a whole section should keep an consistency to only one perspective.
** Articles describing walkthroughs, or being any other sorts of a guide, should use second person perspective, dictating clear and simple instructions to the player. Tips sections can be made in both second or third person perspective, however a whole section should keep an consistency to only one perspective.


==Prefence standardisation for languages, unit systems and decimal notation==
==Preference standardisation for languages, unit systems and decimal notation==
Given a wide reach of INFRA community, discrepencies between British English (BrE), American English (AmE) and non-native English speakers, and inconsistencies between wiki articles, occur.
Given a wide reach of INFRA community, discrepencies between British English (BrE), American English (AmE) and non-native English speakers, and inconsistencies between wiki articles, occur.


Line 18: Line 18:
* A specific spelling of certain words that are shared between both BrE and AmE is acceptable to be used from both languages as long as the consistency of that specific spelling is kept within a whole page, for example: a page using "Behaviour" (BrE) or "Behavior" (AmE) should keep the same spelling throughout the whole article it is used, two different spellings should not be mixed together.
* A specific spelling of certain words that are shared between both BrE and AmE is acceptable to be used from both languages as long as the consistency of that specific spelling is kept within a whole page, for example: a page using "Behaviour" (BrE) or "Behavior" (AmE) should keep the same spelling throughout the whole article it is used, two different spellings should not be mixed together.
** The official games may prioritise a specific way of spelling words, in that case if the written article is directly based on a source from the game, where that specific spelling is used, it must be prioritised, for instance: ''[[:File:Folder_001_paper_skin8.png|Turnip Hill - Status report]]'' uses "Behaviour" (BrE), while ''[[:File:Papers_001_skin3.png|The acquisition of Bergmann Group]]'' uses "Defense" (AmE), should a wiki page be created directly based on the content of these, these specific ways of spellings would need to be prioritised and kept consistent within that page.
** The official games may prioritise a specific way of spelling words, in that case if the written article is directly based on a source from the game, where that specific spelling is used, it must be prioritised, for instance: ''[[:File:Folder_001_paper_skin8.png|Turnip Hill - Status report]]'' uses "Behaviour" (BrE), while ''[[:File:Papers_001_skin3.png|The acquisition of Bergmann Group]]'' uses "Defense" (AmE), should a wiki page be created directly based on the content of these, these specific ways of spellings would need to be prioritised and kept consistent within that page.
* If you really must be reviewing the whole page to correct every word entirely to either BrE or AmE, going beyond correcting common typos and mistakes, the British English should be prioritised (taking into the account the previously established points), otherwise the page should be left with a proper spelling/vocabulary that was already established before.
* If you really must be reviewing the whole page to correct every word entirely to either BrE or AmE, going beyond correcting common typos and mistakes, the British English should be prioritised (taking into the account the previously established points), otherwise the page should be left with a proper spelling/vocabulary they way it was already established before.
* When including various numbers, values, units, measurements and calculations in the article page, the [[:wikipedia:International System of Units|International System of Units]] (SI) and SI-derivative systems are to be used, and only those.
* When including various numbers, values, units, measurements and calculations in the article page, the [[:wikipedia:International System of Units|International System of Units]] (SI) and SI-derivative systems are to be used, and only those.
* For decimal notation, the comma (,) is used as the definite decimal separator in all articles.
* For decimal notation, the comma (,) is used as the definite decimal separator in all articles.
csseditors
1,633

edits