Violinwiki:Style guide

From Violinwiki
Jump to: navigation, search

Language

The following points list language requirements for the Violinwiki articles:

  • Correct grammar
  • Appropriate vocabulary
  • Correct terminology
  • Intelligible and unambiguous language
  • Clear and concise language expressing exactly what is supposed to convey.

Formatting

Content has always priority over formatting. Some types of articles use article templates, the formatting is defined already. The articles that do not use article templates should have a clear flow of the text.

Preciseness

Preciseness is the name of the game on the Violinwiki.

Whenever it is possible to refer to the original sources, please do so. Avoid stating unsupported facts. For example, when writing a biography and you have no direct proof of composer's nationality, do not write his nationality even if you may think that it is obvious. It is better to write just the country where he composed and published his works, just the known, verified and verifiable facts. Violinwiki:Fact checking lists online sources that can help checking various facts.

Biographies

When writing biographies, please check the person's biographical data and nationality using one or more of the addresses below:

More links are listed in Violinwiki:Fact checking.

Lists of works

When writing about the violin books or the violin pieces, check they physically exist. Either you own them or it is possible to loan them from a library. Library links are listed in Violinwiki:Fact checking.

Etude or piece analysis

In the etude or the piece analysis there is not so much referencing the source as explaining the logic behind the choice, be it fingering, bowing or the style of the piece. Still, if it is possible to reference the original source of fingering, bowing or other information, please do so. Do not use sentence My teacher told me so as reference. If you are still in contact, ask him for the original source.

Vague statements such as I think I read somewhere... I think I heard ... are not acceptable on Violinwiki. Templates {{Citation needed}} or {{Clarify}} are available for identifying such statements.

Puffery

This section was adopted from Wikipedia.

... legendary, great, the greatest, acclaimed, visionary, outstanding, leading, celebrated, award-winning, landmark, cutting-edge, innovative, extraordinary, brilliant, hit, famous, renowned, remarkable, prestigious, world-class, respected, notable, virtuoso, honorable, awesome, unique ...

Peacock terms.png

Words such as these are often used without attribution to promote the subject of an article, while neither imparting nor plainly summarizing verifiable information.

Such articles should be rewritten to comply with Violinwiki guidelines. Templates are available for identifying such statements.

Weasel words

This section was partly taken verbatim from Wikipedia.

... some people say, many scholars state, it is believed/regarded, many are of the opinion, most feel, experts declare, it is often reported, it is widely thought, research has shown, science says, it is often said ...

Weasel words.svg

Weasel words are words and phrases aimed at creating an impression that something specific and meaningful has been said, when in fact only a vague or ambiguous claim has been communicated. A common form of weasel wording is through vague attribution, where a statement is dressed with authority, yet has no substantial basis. Phrases such as those above present the appearance of support for statements but can deny the reader the opportunity to assess the source of the viewpoint. They may disguise a biased view. Claims about what people say, think, feel, or believe, and what has been shown, demonstrated, or proved should be clearly attributed.

Template use

Templates are described in the Template guide. It is advised to use them, their usage saves editor's time and eases the maintenance of the wiki.

Musical notation

It is possible to enter musical notation and musical symbols in several ways. For inline musical symbols such as quarter note = 132, treble clef or C major to be used in the text, use the template {{music}}. Its numerous possibilities and usage are documented on the template page. For larger musical examples requiring musical staff please use the template {{Score}} containing the <score> tag which enables using lilypond or abc syntax inside wikitext. See Help:Musical notation for the detailed description of the usage of the <score> tag and template {{Score}} for its usage.

Linking

Avoid internal overlinking, use links only where they are relevant, such as from a book to an author, from a composer to the pieces, from piece analysis the to techniques, etc., between various parts of Violinwiki. Use interwiki linking only where it is relevant and it is linking to information that is outside of scope of Violinwiki. For example, creating an interwiki link to Paris in Wikipedia when the composer was born in Paris is redundant and worsening the article readability.

Categorization

Avoid category pollution, that is the main contents categories contain only pages from the Main namespace, not from the user or the project namespaces. Categories are organized in natural hierarchy on Violinwiki, Special:CategoryTree/Contents shows the latest Violinwiki hierarchy structure. See Help:Categories for the detailed information on categories. The exception to the hierarchical structure are portal pages in the Category:Portals. The portal pages are not the subject pages but act as little gateways to the various parts of Violinwiki.

Name conventions

Name conventions are defined in Naming conventions and should be adhered to precisely.