Jump to content

Style guide

From Wikipedia, the free encyclopedia

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 for either general use, or prescribed use in an individual publication, particular organization, or specific field.

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.[2]

Style guides may be categorized into three types: comprehensive style for general use; discipline style for specialized use, which is often specific to academic disciplines, medicine, journalism, law, government, business, and other industries; and house or corporate style, created and used by a particular publisher or organization.[3]

Varieties

[edit]

Style guides vary widely in scope and size. Writers working in large industries or professional sectors may reference a specific style guide, written for 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 United Kingdom's New Oxford Style Manual from Oxford University Press; and the United States' The Chicago Manual of Style from the University of Chicago Press. Australia has a style guide, available online, created by its government.[4]

Sizes

[edit]

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 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

[edit]

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.[5]

Web style guides

[edit]

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.[6] 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.[6]

Updating

[edit]

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

[edit]

References

[edit]
  1. ^ Shigwan, Ramchandra (2016). "Chicago and Apa Style Manual in Research Activities: A Comparative Study". Bulletin of the Deccan College Post-Graduate and Research Institute. 76: 163–172. ISSN 0045-9801.
  2. ^ "The Whys and Hows of Translation Style Guides. A Case Study". American Translators Association (ATA). 17 September 2019. Retrieved 7 November 2024.
  3. ^ Bright, Mark R. (2005). "Creating, Implementing, and Maintaining Corporate Style Guides in an Age of Technology". Technical Communication. 52 (1): 42–51. ISSN 0049-3155.
  4. ^ "Australian Government Style Manual". Australian Government Style Manual.
  5. ^ "Write accessible documentation | Google developer documentation style guide". Google for Developers. 9 November 2023. Retrieved 18 November 2023.
  6. ^ a b 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. doi:10.5565/rev/tradumatica.104. ISSN 1578-7559. Archived from the original on 18 November 2023.
[edit]