Difference between revisions of "Style Guide 2015"

Revision as of 10:10, 21 May 2015

In keeping with our descriptive and collective mission, entries can be added and edited by any Northwestern user with a WildWords account. To maintain uniformity and clarity of information, we ask that every entry follow both the WildWords Style Guide and the WildWords Entry Layout. As an Editorial Board, we reserve the right to reformat or remove any such entries that do not comply to these standards. These style guides and entry layout forms were adapted from the foundational success of documents of the same name at Wiktionary.com, a dictionary with a similar online format, but a particular international focus. We are indebted to their example of a crowd sourced online dictionary. Questions and concerns should be directed to nudictionary@mmlc.northwestern.edu. Enjoy WildWords!

The Basic Entry

Instructions and templates for Wikimarkup format for entries can be found on the Entry Layout for WildWords.

Part of Speech

This is usually the first information directly after the headword. This header most often shows the part of speech, but is not restricted to “parts of speech” in the traditional sense. Many other descriptors like “Proper noun”, “Idiom”, “Abbreviation”, “Symbol”, “Prefix”, etc.

Pronunciation/Alternate Forms and Pronunciation

For words with only one form, the section title will simply be “Pronunciation”. Each entry should include a respelled version (following the WildWords Respelling Guide), placed in brackets, and should be followed by an audio file. For words with alternate or multiple forms (e.g. Weinberg vs. Weinberg College of Arts and Sciences), these will be included under the section title “Alternate Forms and Pronunciations”, with each form put in a numbered list. The respelling of each alternate form will be placed in brackets following the term, and there should be an audio sample following each form.

WildWords uses a custom MediaWiki SoundCloud widget to play sound clips, which means the easiest method of uploading sound samples is to save the sound clip on the SoundCloud website and then display an audio file on the WildWords page. WikiMarkup code for audio files can be found on the WildWords Entry Layout page.

Usage

Each entry should include a description of the speech community that uses it and in what contexts it is used. For example, this may include whether it is used by the greater Northwestern community or a specific organization, if it is used in formal or informal contexts, or if it is used in spoken word or written text. If the entry is used by the greater Northwestern community, the sentence “This term is used by the Northwestern community at large” would suffice.

Descriptions

The descriptions are the most fundamental piece of an encyclopedic dictionary. They should be concise but thorough, consisting of around four sentences. The goal is to provide readers with the necessary cultural information and context to be able to understand and use the word, without excess information or trivia. The description may consist of sentence fragments and complete sentences, with a preference for complete sentences.

Numbering

An entry with a single description should not have a numeral. If the entry has multiple descriptions, then they should be added one after another in a numeric list. When the entry has multiple descriptions, they should be ordered from the most common usage to the least.

Words in Descriptions

The use of technical and obscure words in descriptions should be kept to an absolute minimum. When it is necessary or useful to use less common words, these should always have a succinct explanation on the page. It can also be helpful to link to a corresponding WildWords or Wiktionary page.

Patterns

The key information should be placed as close to the beginning of the definition as grammar and elegance permit. Formatting the entry in this way will assist casual users in quickly locating the information they need.

Verbs: Definitions of verbs should begin with "to".

• To walk briskly.

Nouns: Definitions of nouns should begin with a definite or indefinite article. Usually an uncountable sense will take a definite article (the), while a countable sense will usually take an indefinite article (a/an.

• A domesticated species of canine animal, commonly kept as a house pet.
• the invisible gaseous substance surrounding the earth, a mixture mainly of oxygen and nitrogen.

Adjectives: The more concise construction, the better:

• Having a yellow color.

Example sentences

Generally, every description should be accompanied by a quotation illustrating the description. If no quotation can be found, it is strongly encouraged to create an example sentence. Example sentences should:

• be grammatically complete sentences, beginning with a capital letter and ending with a period, question mark, or exclamation point.
• be placed immediately after the applicable numbered description, and before any quotations associated with that specific description.
• be italicized, with the defined term boldfaced.
• be as brief as possible while still clarifying the sense of the term. (In rare cases, examples consisting of two brief sentences may work best.)
• be indented using the “#:” command placed at the start of the line.
• not contain wikilinks (the words should be easy enough to understand without additional lookup)

Optional Headings

Etymologies

An etymology of each term is encouraged if it is relevant to the understanding of the term, and if any information on the history and coinage of the word is available.

Related Terms

Entries that include related WildWords terms should list the wikilink to the WildWords page for that page. This heading is meant for words that are either already entered in WildWords or could be entered in the future.

External Links

Any other websites that are connected to the word should be linked under the heading External Links, below the related terms.

References

References are are required when the information is sourced from another website, magazine, or other source. If no outside source was consulted, then it is not necessary.

General considerations

Capitalization of Entry and Section Titles

use http://www.chicagomanualofstyle.org/16/ch08/ch08_sec157.html

Punctuation

Quotation marks

WIldWords favors the use of double quotation marks (" " or “ ”) rather than single ones (' ' or ‘ ’). Single quotes are normally used only when one quotation is enclosed within another. Wilwords usage places any terminal punctuation outside of the quotation marks, unless it is actually part of the quote.

Commas

Include the serial (or Oxford) comma, the final comma before the last element in a list. Eg. ... red, white, and blue.

Interwiki Links

Related words with their own WildWords pages used in the description of an entry should be wikilinked through bracket notation. An example can be found on the Entry Layout page.

Placement of Content

Most content elements should be in the main (center) section of the page. Accepted items that may appear on the right-hand side:

• Images
• Video Examples
• Usage Polls

When possible the width of right-hand side elements should be uniform so as to provide a "virtual" right-hand side column. Example wikimarkup can be found on the Entry Layout page.