Manual of style: Difference between revisions

From DM Live - the Depeche Mode live encyclopedia for the masses
Jump to navigationJump to search
m (Protected "Manual of style" ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite)))
 
(20 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{Policy|guideline|official}}
{{Policy|guideline|official}}


This is an instruction '''manual''' that addresses the conventions adopted by DM Live in writing, titles, articles, and linking. Please read it before you contribute to the DM Live project.
This is an instruction '''manual''' written to assist editors in understanding the standards adopted by DM Live with regards to writing, titles, articles, and linking to site content. It is recommended to read this manual prior to contributing to the DM Live project, as it includes tips and tricks to help you get started.


==Article titles==
==Article titles==
Line 22: Line 22:


Be sure to check for obvious spelling or grammatical errors before entering a page; if you notice factual or spelling errors on a page, please feel free to correct the issue, as DM Live is an open project to all. In order to avoid disagreements over factual accuracy, it is best to cite sources wherever possible, especially for controversial statements.
Be sure to check for obvious spelling or grammatical errors before entering a page; if you notice factual or spelling errors on a page, please feel free to correct the issue, as DM Live is an open project to all. In order to avoid disagreements over factual accuracy, it is best to cite sources wherever possible, especially for controversial statements.
=== How to use references ===
To cite a source for a statement or quote, place <code><nowiki><ref></ref></nowiki></code> tags after the sentence that uses information from a source. For quotes, the reference tags should be placed after the period and quotation mark.
==== How to use named references ====
For multiple statements or quotes that originate from a single source, it is recommended to use named references. Named references allow you to quickly repeat the source information for multiple sections of text without having to manually write out the source information each time. To create a named reference, use <code><nowiki><ref name="RefName"></ref></nowiki></code>.
For example, the following markup:
<code><nowiki>This sentence uses information derived from a third-party.<ref name="Ref1">Source: Reference 1.</ref> The following sentence also uses information from that same source, so we will cite the same source at the end of this sentence.<ref name="Ref1"></ref>.</nowiki></code>
Will produce the following when rendered on a page (note that the references cited in this sentence now appear at the bottom of this page under the [[Manual of style#References|References]] section):
This sentence uses information derived from a third-party.<ref name="Ref1">Source: Reference 1.</ref> The following sentence also uses information from that same source, so we will cite the same source at the end of this sentence.<ref name="Ref1"></ref>.
===Quotes===
When writing brief one or two sentence quotes, please integrate the quote into a sentence naturally or use a colon. For example:
Dave Gahan and Martin Gore stated in a 2013 ''Rolling Stone'' interview: "Lorem ipsum dolor sit amet, consectetur adipiscing elit."
====Block quotes====
When handling long quotes exceeding 40 words in length, please wrap the full quote in <code><nowiki><blockquote></blockquote></nowiki></code> tags. Block quotes should always start on their own line, and quotation marks should '''not''' be used. Any reference citations (which are added using <code><nowiki><ref></ref></nowiki></code> tags) should appear after the punctuation at the end of the block quote.
For example, the following markup:
<code><nowiki><blockquote>Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.<ref>Example reference.</ref></blockquote></nowiki></code>
Will produce this when rendered on a page:
<blockquote>Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.<ref>Example reference.</ref></blockquote>
== Names of bands ==
It is recommended to write the full name of a musical act as opposed to using abbreviations in all cases (always write "Depeche Mode", never "DM"). Remember to write from the perspective that the reader is completely unfamiliar with the group.


==Names of people==
==Names of people==
When a person has a specific preference for the way their name is written, or where convention differs, please use that instead. For example, use [[Dave Gahan]] rather than David Gahan.
When a person has a specific preference for the way their name is written, or where convention differs, please use that instead. For example, use [[Dave Gahan]] rather than David Gahan.
==Names of websites, magazines, books, television/radio programmes==
Always italicize titles if the source is self-contained and independent. Titles of books, films, websites, magazines, newspapers, books, television and radio programmes are italicized. Place titles in quotation marks if the source is part of a larger work. Third-party articles, essays, chapters, poems, webpage titles, songs, and names of speeches are placed in quotation marks.
==Names of concerts==
When writing expository text that refers to specific concert dates, it is recommended to write the name of the city in which the concert took place with an embedded link to the page for that concert. This is done by inserting a pipe symbol after the link to the page followed by the name of the city. In cases where the concert in question is noteworthy or famous in some way, such as the [[1988-06-18 Rose Bowl, Pasadena, CA, USA|Rose Bowl]] concert, defer instead to the name of the venue. This reference style is helpful as it helps communicate concert dates without interrupting the flow of the sentence.
For example, consider the following sentence: <nowiki>"The next two concerts, [[1981-08-06 Warehouse, Leeds, England, UK]], and [[1981-08-07 Nite Club, Edinburgh, Scotland, UK]], do not currently have any available recordings."</nowiki> This statement is poorly formatted, as the full titles of the concerts break the flow of the sentence and make it harder to read. This sentence would be better written as <nowiki>"The next two concerts, [[1981-08-06 Warehouse, Leeds, England, UK|Leeds]], and [[1981-08-07 Nite Club, Edinburgh, Scotland, UK|Edinburgh]], do not currently have any available recordings"</nowiki>, which renders as "The next two concerts, [[1981-08-06 Warehouse, Leeds, England, UK|Leeds]], and [[1981-08-07 Nite Club, Edinburgh, Scotland, UK|Edinburgh]], do not currently have any available recordings."


==Image preferences==
==Image preferences==
Line 33: Line 76:
==Page formatting preferences==
==Page formatting preferences==
* Obtrusively bright colours used for backgrounds or templates generally should be avoided. DM Live favors neutral colours such as greys, blacks, and whites for most elements, saving bright or potentially-distracting colours for important elements meant to catch the viewer's eye or as accents depending on the content. Borders with a thickness of 1px are preferred for tables used to display data or text, with thicker borders saved for non-article uses.
* Obtrusively bright colours used for backgrounds or templates generally should be avoided. DM Live favors neutral colours such as greys, blacks, and whites for most elements, saving bright or potentially-distracting colours for important elements meant to catch the viewer's eye or as accents depending on the content. Borders with a thickness of 1px are preferred for tables used to display data or text, with thicker borders saved for non-article uses.
* The title of an album, song compilation, video release, video compilation, and other official releases that contain a collection of works should be italicized. In contrast, italics should not be used when writing the titles of individual songs. Song names are always wrapped in apostrophes and linked where possible.
* The title of an album, song compilation, video release, video compilation, and other official releases that contain a collection of works should be italicized. In contrast, italics should not be used when writing the titles of individual songs. Song names are always wrapped in apostrophes and linked where possible.
**It is recommended to use the '''<nowiki>{{S}}</nowiki>''' template to easily format song titles. For example, '''<nowiki>{{S|Halo}}</nowiki>''' produces {{S|Halo}}, complete with quotation marks and an embedded link to the song's page. If an embedded link is not required, writing '''<nowiki>{{S|Halo|U}}</nowiki>''' will produce {{S|Halo|U}} without the embedded link.
 
==External links==
Links to trusted external sites (such as {{EL|http://depechemode.com/ depechemode.com}} can be linked to using the <nowiki>{{EL}}</nowiki> template. For example, to link to depechemode.com, write: <code><nowiki>{{EL|http://depechemode.com/ depechemode.com}}</nowiki></code>. The text following the URL is what will display when the page is rendered, with the URL embedded within the text.


==Third-party content==
==Third-party content==
Line 39: Line 86:


===Wikipedia content===
===Wikipedia content===
Please do not copy any text from Wikipedia directly into DM Live. DM Live strives for all written content to be original for legal and style reasons.
Please do not copy any text from Wikipedia directly into DM Live. DM Live strives for all written content to be original for legal reasons.


-----
-----
We at DM Live are here to create and maintain the most accurate and all-encompassing encyclopedia of Depeche Mode information available. Your smallest contribution is always appreciated by us and the entire Depeche Mode community.
We at DM Live are here to create and maintain the most accurate and all-encompassing encyclopedia of Depeche Mode information available. Your smallest contribution is always appreciated by us and the entire Depeche Mode community.
{{-}}
{{-}}
== References ==
[[Category:Guides]]

Latest revision as of 17:40, 17 June 2020

DM Live Logo (clear BG).png
This article is an official site guideline.

It is strongly recommended to follow the suggestions outlined in this article when contributing to DM Live.

This is an instruction manual written to assist editors in understanding the standards adopted by DM Live with regards to writing, titles, articles, and linking to site content. It is recommended to read this manual prior to contributing to the DM Live project, as it includes tips and tricks to help you get started.

Article titles

The conventions for titles dictate that all proper nouns, locations, and names of people are capitalized unless specifically not capitalized. Titles are not written like book titles (where most words are capitalized) unless the article is about a book); note the title of this page is Manual of style, not Manual of Style.

Uniformity in the titling of articles is important as it makes for a professional appearance and adds consistency to the user experience. Any page title that includes a name should not be stored in a biographical format; i.e., "Daryl Bamonte", not "Bamonte, Daryl" as the page title for Daryl Bamonte. Titles referring to topics where there is more than one subject should be kept singular, such as ARP 2600 rather than ARP 2600s, Microphone rather than Microphones, and so on.

Opening line

The full linked name of the subject of an article should appear within the first few words of the article before the first page section. Any alternate names may be described later in the article.

Style of writing

This site is designed to be an encyclopedia, and as such, all DM Live editors must use the best possible level of literary style free of bias, typos, grammatical errors, and other issues that may inhibit users' ability to comprehend site content. It is important to write in such a way that a non-Depeche Mode fan can understand the meaning of a passage. For example, introducing a quote as "Alan writes on Shunt:" is incorrect, whereas "Former member Alan Wilder writes in response to a fan question regarding the use of a sample in the song 'Personal Jesus':" is preferable, as it provides key background context allowing readers to better understand the material.

To avoid repetitive blocks of text, it is recommended to fully write and link an individual's first and last name when mentioning them for the first time, and then use only their last name without a link for additional mentions within that page section. Please link to an article only once within a given portion of text whenever possible. In cases where there are multiple occurrences of a word with a notable distance between them, these may be linked multiple times at your discretion.

As a site dedicated to English music group Depeche Mode, use of British English is recommended when making edits to DM Live wherever possible. This helps to establish continuity between background text and direct quotes from group members, which often feature distinct British vocabulary (and, importantly, humour). Flag UK.png

Point of view

It is recommended to avoid writing from a second person point of view, as this is informal and generally unsuitable for an encyclopedia. "You can hear Dave Gahan's backing vocals during the first two choruses of 'Home'" is incorrect, while "Dave Gahan's backing vocals can be heard during the first two chorus sections of 'Home'" is correct.

Be sure to check for obvious spelling or grammatical errors before entering a page; if you notice factual or spelling errors on a page, please feel free to correct the issue, as DM Live is an open project to all. In order to avoid disagreements over factual accuracy, it is best to cite sources wherever possible, especially for controversial statements.

How to use references

To cite a source for a statement or quote, place <ref></ref> tags after the sentence that uses information from a source. For quotes, the reference tags should be placed after the period and quotation mark.

How to use named references

For multiple statements or quotes that originate from a single source, it is recommended to use named references. Named references allow you to quickly repeat the source information for multiple sections of text without having to manually write out the source information each time. To create a named reference, use <ref name="RefName"></ref>.

For example, the following markup:

This sentence uses information derived from a third-party.<ref name="Ref1">Source: Reference 1.</ref> The following sentence also uses information from that same source, so we will cite the same source at the end of this sentence.<ref name="Ref1"></ref>.

Will produce the following when rendered on a page (note that the references cited in this sentence now appear at the bottom of this page under the References section):

This sentence uses information derived from a third-party.[1] The following sentence also uses information from that same source, so we will cite the same source at the end of this sentence.[1].

Quotes

When writing brief one or two sentence quotes, please integrate the quote into a sentence naturally or use a colon. For example:

Dave Gahan and Martin Gore stated in a 2013 Rolling Stone interview: "Lorem ipsum dolor sit amet, consectetur adipiscing elit."

Block quotes

When handling long quotes exceeding 40 words in length, please wrap the full quote in <blockquote></blockquote> tags. Block quotes should always start on their own line, and quotation marks should not be used. Any reference citations (which are added using <ref></ref> tags) should appear after the punctuation at the end of the block quote.

For example, the following markup:

<blockquote>Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.<ref>Example reference.</ref></blockquote>

Will produce this when rendered on a page:

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.[2]

Names of bands

It is recommended to write the full name of a musical act as opposed to using abbreviations in all cases (always write "Depeche Mode", never "DM"). Remember to write from the perspective that the reader is completely unfamiliar with the group.

Names of people

When a person has a specific preference for the way their name is written, or where convention differs, please use that instead. For example, use Dave Gahan rather than David Gahan.

Names of websites, magazines, books, television/radio programmes

Always italicize titles if the source is self-contained and independent. Titles of books, films, websites, magazines, newspapers, books, television and radio programmes are italicized. Place titles in quotation marks if the source is part of a larger work. Third-party articles, essays, chapters, poems, webpage titles, songs, and names of speeches are placed in quotation marks.

Names of concerts

When writing expository text that refers to specific concert dates, it is recommended to write the name of the city in which the concert took place with an embedded link to the page for that concert. This is done by inserting a pipe symbol after the link to the page followed by the name of the city. In cases where the concert in question is noteworthy or famous in some way, such as the Rose Bowl concert, defer instead to the name of the venue. This reference style is helpful as it helps communicate concert dates without interrupting the flow of the sentence.

For example, consider the following sentence: "The next two concerts, [[1981-08-06 Warehouse, Leeds, England, UK]], and [[1981-08-07 Nite Club, Edinburgh, Scotland, UK]], do not currently have any available recordings." This statement is poorly formatted, as the full titles of the concerts break the flow of the sentence and make it harder to read. This sentence would be better written as "The next two concerts, [[1981-08-06 Warehouse, Leeds, England, UK|Leeds]], and [[1981-08-07 Nite Club, Edinburgh, Scotland, UK|Edinburgh]], do not currently have any available recordings", which renders as "The next two concerts, Leeds, and Edinburgh, do not currently have any available recordings."

Image preferences

  • Original photographs, artwork, or other official imagery is always preferred.
  • In cases where there is no official image of an acceptable quality available, images created by the contributing user are preferred over imagery taken from a third-party sources.
  • Overwriting existing images is permitted, as DM Live always favors the image with the highest quality. With this in mind, please make an effort to avoid disputes by discussing the desired change with the user who uploaded the former image prior to uploading the new version.

Page formatting preferences

  • Obtrusively bright colours used for backgrounds or templates generally should be avoided. DM Live favors neutral colours such as greys, blacks, and whites for most elements, saving bright or potentially-distracting colours for important elements meant to catch the viewer's eye or as accents depending on the content. Borders with a thickness of 1px are preferred for tables used to display data or text, with thicker borders saved for non-article uses.
  • The title of an album, song compilation, video release, video compilation, and other official releases that contain a collection of works should be italicized. In contrast, italics should not be used when writing the titles of individual songs. Song names are always wrapped in apostrophes and linked where possible.
    • It is recommended to use the {{S}} template to easily format song titles. For example, {{S|Halo}} produces "Halo", complete with quotation marks and an embedded link to the song's page. If an embedded link is not required, writing {{S|Halo|U}} will produce "Halo" without the embedded link.

External links

Links to trusted external sites (such as depechemode.com can be linked to using the {{EL}} template. For example, to link to depechemode.com, write: {{EL|http://depechemode.com/ depechemode.com}}. The text following the URL is what will display when the page is rendered, with the URL embedded within the text.

Third-party content

It is against DM Live's policy to directly copy text from other websites without permission from the original author. The only exception to this rule is if a third-party source consents to allowing their work to appear on DM Live and be subsequently edited and expanded upon to meet DM Live's style and standards, in which case editors may directly copy their text into DM Live. In these cases, the source must be credited using reference tags.

Wikipedia content

Please do not copy any text from Wikipedia directly into DM Live. DM Live strives for all written content to be original for legal reasons.


We at DM Live are here to create and maintain the most accurate and all-encompassing encyclopedia of Depeche Mode information available. Your smallest contribution is always appreciated by us and the entire Depeche Mode community.

References

  1. 1.0 1.1 Source: Reference 1.
  2. Example reference.