Level of detail (writing)

Last updated

Level of detail in writing, sometimes known as level of abstraction, refers to three concepts: the precision in using the right words to form phrases, clauses and sentences; [1] the generality of statements; and the organisational strategy in which authors arrange ideas according to a common topic in the hierarchy of detail. Placing different objects or ideas in categories is a type of classification in expert writing which allows more efficient cognitive retrieval of information by placing it in context. [2] Maintaining appropriate level of detail in any body of text is a part of ensuring that the cognitive effort required by the reader is appropriate to the general subject of the written as a whole. Authors use level of detail to maintain continuity in syntactic hierarchy in texts, such as a screenplays. [3] Continuity in text is achieved by using transitional expressions to move from one detail, or level of detail, to another. [4]

Within the basic writing structure of introducing, characterising and bringing to a close of any proper subject description, [5] level of detail is used in theme development during elaboration, evaluation and adding context as a repertoire of retrieval strategies. [6] Van der Pool in 1995 had found that omission of detail in text structuring is an age-related effect that differentiates mature and young writers. [7]

Although the general rule that the level of detail must be both sufficient and appropriate for the author's audience and their subject in literature intended for experts, [8] it is also used in primary and secondary education to assess student understanding. [9] In general the depth of detail is gradually developed to one appropriate for the subject. [10]

The suggested list in identifying appropriate level of detail may include [11]

Presenting the reader with specific details without first introducing it with general statements can be dangerous because it omits a qualifier, and therefore introduces elements that invite questions and create confusion. [12]

Level of detail is often important in technical writing due to the need to differentiate between different levels of audience need for information within the organisation. [13]

Similar to the engineering design process, writing also takes place by the author usually adopting either a top-down or a bottom-up process by identifying components of the text that become the focus subjects in the overall theme. [14]

The content of a text is often assessed for its level of detail as high, intermediate or low based on the objective of the author in addressing the needs of the audience. The highly detailed text refers to the bottom-up structuring design where

Facts that are generally available but not used frequently (and likely to be forgotten) should be included in this ideal level of writing. [15]

This level of detail is appropriate for the subjects where expert specialist knowledge and understanding are required, and is often used in technical and scientific writing, or in literary genres like science fiction, biographical writing or military history.

Citations and notes

  1. p.204, Wilson, Ferster-Glazie
  2. p.396, MacArthur, Graham, Fitzgerald
  3. p.227, Kitchen
  4. p.223, Wilson, Ferster-Glazie
  5. p.204, Wilson, Ferster-Glazie
  6. p.395, MacArthur, Graham, Fitzgerald
  7. pp.395-396, MacArthur, Graham, Fitzgerald
  8. p.25, Campbell
  9. p.180, Levstik, Barton
  10. p.59, Alley
  11. p.25, Campbell
  12. p.80, Alley
  13. p.198, Alred, Brusaw, Oliu
  14. p.1018, Weik
  15. p.19, Harkins & Plung

Related Research Articles

Essay Written work often reflecting the authors personal point of view

An essay is, generally, a piece of writing that gives the author's own argument — but the definition is vague, overlapping with those of a paper, an article, a pamphlet, and a short story. Essays have traditionally been sub-classified as formal and informal. Formal essays are characterized by "serious purpose, dignity, logical organization, length," whereas the informal essay is characterized by "the personal element, humor, graceful style, rambling structure, unconventionality or novelty of theme," etc.

Nonfiction or non-fiction is any document, or content that purports in good faith to represent truth and accuracy regarding information, events, or people. Nonfiction content may be presented either objectively or subjectively, and may sometimes take the form of a story. Nonfiction is one of the fundamental divisions of narrative writing— in contrast to fiction, which offers information, events, or characters expected to be partly or largely imaginary, or else leaves open if and how the work refers to reality.

News style, journalistic style, or news-writing style is the prose style used for news reporting in media such as newspapers, radio and television.

Information mapping research-based method for writing clear and user focused information, based on the audiences needs and the purpose of the information.

Information mapping is a research-based method for writing clear and user focused information, based on the audience's needs and the purpose of the information. The method is applied primarily to designing and developing business and technical communications. It is used as a content standard within organizations throughout the world.

Table of contents Ordered list of the parts of a written work

A table of contents, usually headed simply Contents and abbreviated informally as TOC, is a list, usually found on a page before the start of a written work, of its chapter or section titles or brief descriptions with their commencing page numbers.

A technical writer is a professional information communicator whose task is to transfer information (knowledge) 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.

Scientific literature comprises scholarly publications that report original empirical and theoretical work in the natural and social sciences, and within an academic field, often abbreviated as the literature. Academic publishing is the process of contributing the results of one's research into the literature, which often requires a peer-review process.

Narrative exposition is the insertion of background information within a story or narrative. This information can be about the setting, characters' backstories, prior plot events, historical context, etc. In literature, exposition appears in the form of expository writing embedded within the narrative. Exposition is one of four rhetorical modes, along with description, argumentation, and narration, as elucidated by Alexander Bain and John Genung.

Narration is the use of a written or spoken commentary to convey a story to an audience. Narration encompasses a set of techniques through which the creator of the story presents their story, including:

Technical writing is writing or drafting technical communication used in technical and occupational fields, such as computer hardware and software, engineering, chemistry, aeronautics, robotics, finance, medical, consumer electronics, biotechnology, and forestry. Technical writing encompasses the largest sub-field in technical communication.

The Darwin Information Typing Architecture or Document Information Typing Architecture (DITA) is an XML data model for authoring and publishing. It is an open standard that is defined and maintained by the OASIS DITA Technical Committee.

Audience analysis is a task that is often performed by technical writers in a project's early stages. It consists of assessing the audience to make sure the information provided to them is at the appropriate level. The audience is often referred to as the end-user, and all communications need to be targeted towards the defined audience. Defining an audience requires the consideration of many factors, such as age, culture and knowledge of the subject. After considering all the known factors, a profile of the intended audience can be created, allowing writers to write in a manner that is understood by the intended audience.

Professional writing as an activity is writing for reward or as a profession; as a product or object, professional writing is any form of written communication produced in a workplace environment or context that enables employees to, for example, communicate effectively among themselves, help leadership make informed decisions, advise clients, comply with federal, state, or local regulatory bodies, bid for contracts, etc.. For example, in a business office, a memorandum can be used to provide a solution to a problem, make a suggestion, or convey information. Other forms of professional writing commonly generated in the workplace include email, letters, reports, and instructions. In seeking to inform, persuade, instruct, stimulate debate, or encourage action from recipients, skilled professional writers make adjustments to different degrees of shared context, e.g., from a relatively accessible style useful for unsolicited contact letter to prospective clients to a technical report that relies on a highly specialized in-house vocabulary.

Technical illustration Process of visually communicating technical concepts or subjects

Technical Illustration is illustration meant to visually communicate information of a technical nature. Technical illustrations can be components of technical drawings or diagrams. Technical illustrations in general aim "to generate expressive images that effectively convey certain information via the visual channel to the human observer".

Report informational, formal, and detailed text

A report is a document that presents information in an organized format for a specific audience and purpose. Although summaries of reports may be delivered orally, complete reports are almost always in the form of written documents.

Digital literacy refers to an individual's ability to find, evaluate, and compose clear information through writing and other media on various digital platforms. Digital literacy is evaluated by an individual's grammar, composition, typing skills and ability to produce text, images, audio and designs using technology. While digital literacy initially focused on digital skills and stand-alone computers, the advent of the internet and use of social media, has caused some of its focus to shift to mobile devices. Similar to other expanding definitions of literacy that recognize cultural and historical ways of making meaning, digital literacy does not replace traditional forms of literacy, and instead builds upon and expands the skills that form the foundation of traditional forms of literacy. Digital literacy should be considered to be a part of the path to knowledge.

In literature, the tone of a literary work expresses the writer's attitude toward or feelings about the subject matter and audience.

Telegram style Clipped language for writing telegrams

Telegram style, telegraph style, telegraphic style, or telegraphese is a clipped way of writing which abbreviates words and packs information into the smallest possible number of words or characters. It originated in the telegraph age when telecommunication consisted only of short messages transmitted by hand over the telegraph wire. The telegraph companies charged for their service by the number of words in a message, with a maximum of 15 characters per word for a plain-language telegram, and 10 per word for one written in code. The style developed to minimize costs but still convey the message clearly and unambiguously.

Concision is using only the words necessary to convey an idea. It aims to enhance communication by eliminating redundancy without omitting important information. Concision has been described as one of the elementary principles of writing. The related concept of succinctness is the opposite of verbosity.

References