Style guide

Last updated

A style guide is a set of standards for the writing, formatting, and design of documents. [1] A book-length style guide is often called a style manual or a manual of style (MoS or MOS). A short style guide, typically ranging from several to several dozen pages, is often called a style sheet. The standards documented in a style guide are applicable either for general use, or prescribed use for an individual publication, particular organization, or specific field.

Contents

A style guide establishes standard style requirements to improve communication by ensuring consistency within and across documents. They may require certain best practices in writing style, usage, language composition, visual composition, orthography, and typography by setting standards of usage in areas such as punctuation, capitalization, citing sources, formatting of numbers and dates, table appearance and other areas. For academic and technical documents, a guide may also enforce the best practice in ethics (such as authorship, research ethics, and disclosure) and compliance (technical and regulatory). For translations, a style guide may even be used to enforce consistent grammar, tones, and localization decisions such as units of measure.

Style guides are specialized in a variety of ways, from the general use of a broad public audience, to a wide variety of specialized uses (such as for students and scholars of various academic disciplines, medicine, journalism, the law, government, business, and specific industries). The term house style refers to the conventions defined by the style guide of a particular publisher or other organization.

Varieties

Style guides vary widely scope and size. Writers working in many large industries or professional sectors reference a specific style guide, written for their usage in specialized documents within their fields. For the most part, these guides are relevant and useful for peer-to-peer specialist documentation or to help writers working in specific industries or sectors communicate highly technical information in scholarly articles or industry white papers.

Professional style guides of different countries can be referenced for authoritative advice on their respective language(s), such as the New Oxford Style Manual from Oxford University Press, UK; and The Chicago Manual of Style from the University of Chicago Press, US; both Australia and Canada have style guides – available online – created by their governments.

Sizes

The variety in scope and length is enabled by the cascading of one style over another, analogous to how styles cascade in web development and in desktop cascade over CSS styles.

In many cases, a project such as a book, journal, or monograph series typically has a short style sheet that cascades over the somewhat larger style guide of an organization such as a publishing company, whose specific content is usually called house style. Most house styles, in turn, cascade over an industry-wide or profession-wide style manual that is even more comprehensive. Examples of industry style guides include:

Finally, these reference works cascade over the orthographic norms of the language in use (for example, English orthography for English-language publications). This, of course, may be subject to national variety, such as British, American, Canadian, and Australian English.

Topics

Some style guides focus on specific topic areas such as graphic design, including typography. Website style guides cover a publication's visual and technical aspects as well as text.

Guides in specific scientific and technical fields may cover nomenclature to specify names or classifying labels that are clear, standardized, and ontologically sound (e.g., taxonomy, chemical nomenclature, and gene nomenclature).

Style guides that cover usage may suggest descriptive terms for people which avoid racism, sexism, homophobia, etc. Style guides increasingly incorporate accessibility conventions for audience members with visual, mobility, or other disabilities. [2]

Web style guides

Since the rise of the digital age, websites have allowed for an expansion of style guide conventions that account for digital behavior such as screen reading (reading from a digitalized screen rather than a physical document). [3] Screen reading requires web style guides to focus more intently on a user experience subjected to multichannel surfing. Though web style guides can also vary widely, they tend to prioritize similar values concerning brevity, terminology, syntax, tone, structure, typography, graphics, and errors. [3]

Updating

Most style guides are revised periodically to accommodate changes in conventions and usage. The frequency of updating and the revision control are determined by the subject. For style manuals in reference-work format, new editions typically appear every 1 to 20 years. For example, the AP Stylebook is revised annually, and the Chicago, APA, and ASA manuals are in their 17th, 7th, and 6th editions, respectively, as of 2023. Many house styles and individual project styles change more frequently, especially for new projects.

See also

Related Research Articles

<span class="mw-page-title-main">Typography</span> Art of arranging type

Typography is the art and technique of arranging type to make written language legible, readable and appealing when displayed. The arrangement of type involves selecting typefaces, point sizes, line lengths, line spacing, letter spacing, and spaces between pairs of letters. The term typography is also applied to the style, arrangement, and appearance of the letters, numbers, and symbols created by the process. Type design is a closely related craft, sometimes considered part of typography; most typographers do not design typefaces, and some type designers do not consider themselves typographers. Typography also may be used as an ornamental and decorative device, unrelated to the communication of information.

Desktop publishing (DTP) is the creation of documents using page layout software on a personal ("desktop") computer. It was first used almost exclusively for print publications, but now it also assists in the creation of various forms of online content. Desktop publishing software can generate layouts and produce typographic-quality text and images comparable to traditional typography and printing. Desktop publishing is also the main reference for digital typography. This technology allows individuals, businesses, and other organizations to self-publish a wide variety of content, from menus to magazines to books, without the expense of commercial printing.

The comma, is a punctuation mark that appears in several variants in different languages. It has the same shape as an apostrophe or single closing quotation mark in many typefaces, but it differs from them in being placed on the baseline of the text. Some typefaces render it as a small line, slightly curved or straight, but inclined from the vertical. Other fonts give it the appearance of a miniature filled-in figure 9 on the baseline.

A bracket is either of two tall fore- or back-facing punctuation marks commonly used to isolate a segment of text or data from its surroundings. They come in four main pairs of shapes, as given in the box to the right, which also gives their names, that vary between British and American English. "Brackets", without further qualification, are in British English the () marks and in American English the [] marks.

The hyphen is a punctuation mark used to join words and to separate syllables of a single word. The use of hyphens is called hyphenation. Son-in-law is an example of a hyphenated word.

In English writing, quotation marks or inverted commas, also known informally as quotes, talking marks, speech marks, quote marks, quotemarks or speechmarks, are punctuation marks placed on either side of a word or phrase in order to identify it as a quotation, direct speech or a literal title or name. Quotation marks may be used to indicate that the meaning of the word or phrase they surround should be taken to be different from that typically associated with it, and are often used in this way to express irony. They are also sometimes used to emphasise a word or phrase, although this is usually considered incorrect.

Capitalization or capitalisation is writing a word with its first letter as a capital letter and the remaining letters in lower case, in writing systems with a case distinction. The term also may refer to the choice of the casing applied to text.

<span class="mw-page-title-main">Linguistic prescription</span> Prescriptive rules of grammar and usage

Linguistic prescription, or prescriptive grammar, is the establishment of rules defining preferred usage of language. These rules may address such linguistic aspects as spelling, pronunciation, vocabulary, syntax, and semantics. Sometimes informed by linguistic purism, such normative practices often suggest that some usages are incorrect, inconsistent, illogical, lack communicative effect, or are of low aesthetic value, even in cases where such usage is more common than the prescribed usage. They may also include judgments on socially proper and politically correct language use.

A technical writer is a professional information communicator whose task is to transfer information between two or more parties, through any medium that best facilitates the transfer and comprehension of the information. Technical writers research and create information through a variety of delivery media. Example types of information include online help, manuals, white papers, design specifications, project plans, and software test plans. With the rise of e-learning, technical writers are increasingly becoming involved with creating online training material.

In English-language punctuation, a serial comma is a comma placed immediately after the penultimate term in a series of three or more terms. For example, a list of three countries might be punctuated as either "France, Italy and Spain" or "France, Italy, and Spain".

Technical communication is communication of technical subject matter such as engineering, science, or technology content. The largest part of it tends to be technical writing, though importantly it often requires aspects of visual communication. Technical communication also encompasses oral delivery modes such as presentations involving technical material. When technical communication occurs in workplace settings, it's considered a major branch of professional communication. In research or R&D contexts, it can overlap with scientific writing.

In computer programming, whitespace is any character or series of characters that represent horizontal or vertical space in typography. When rendered, a whitespace character does not correspond to a visible mark, but typically does occupy an area on a page. For example, the common whitespace symbol U+0020 SPACE represents a blank space punctuation character in text, used as a word divider in Western scripts.

Capitalization of <i>Internet</i> Conventions for capitalizing word

Orthographic conventions have varied over time, and vary by publishers, authors, and regional preferences, on whether and when Internet should be capitalized. When the Internet first came into common use, most publications treated Internet as a capitalized proper noun, but this has become less common. This reflects the tendency in English to capitalize new terms and move them to lowercase as they become familiar. The word is sometimes still capitalized to distinguish the global IP-based internet from internets that are smaller or not IP-based, though many publications, including the AP Stylebook since 2016, recommend the lowercase form in every case. In 2016, the Oxford English Dictionary found that, based on a study of around 2.5 billion printed and online sources, "Internet" was capitalized in 54% of cases, with Internet being preferred in the United States and internet being preferred in the United Kingdom.

Sentence spacing concerns how spaces are inserted between sentences in typeset text and is a matter of typographical convention. Since the introduction of movable-type printing in Europe, various sentence spacing conventions have been used in languages with a Latin alphabet. These include a normal word space, a single enlarged space, and two full spaces.

The dash is a punctuation mark consisting of a long horizontal line. It is similar in appearance to the hyphen but is longer and sometimes higher from the baseline. The most common versions are the en dash, generally longer than the hyphen but shorter than the minus sign; the em dash, longer than either the en dash or the minus sign; and the horizontal bar, whose length varies across typefaces but tends to be between those of the en and em dashes.

The full stop, period, or full point. is a punctuation mark used for several purposes, most often to mark the end of a declarative sentence.

<span class="mw-page-title-main">History of sentence spacing</span> Evolution of sentence spacing conventions from the introduction of movable type in Europe

The history of sentence spacing is the evolution of sentence spacing conventions from the introduction of movable type in Europe by Johannes Gutenberg to the present day.

Sentence spacing guidance is provided in many language and style guides. The majority of style guides that use a Latin-derived alphabet as a language base now prescribe or recommend the use of a single space after the concluding punctuation of a sentence.

References

  1. "The Guardian and Observer style guide". The Guardian . Retrieved 11 July 2023.
  2. "Write accessible documentation | Google developer documentation style guide". Google for Developers. 9 November 2023. Retrieved 18 November 2023.
  3. 1 2 Jiménez-Crespo, Miguel A.; University (USA), Rutgers (2010). "Localization and writing for a new medium: A review of digital style guides". Tradumàtica: Traducció i tecnologies de la informació i la comunicació (8): 1–9. ISSN   1578-7559. Archived from the original on 18 November 2023.