The ability to read and compose original scientific literature is critical to educating informed citizens, yet may be severely lacking in undergraduate curricula. We developed a linked course offering in fall 2017 consisting of a 16-student group taking an introductory biology course paired with a first-year composition course. The composition…

In the past three decades, the construct of second language (L2) writing complexity has been theorized and refined in both second language acquisition (SLA) (Crossley, 2020; Housen, De Clercq, Kuiken, & Vedder, 2019; Lu, 2011; Norris & Ortega, 2009) and Systemic Functional Linguistics (SFL) research (Byrnes, 2009; Ryshina-Pankova, 2015;…

This essay explores "content," a word and concept now often associated with writing in fields including marketing, journalism, publishing, and technical communication. I present a definition of content appropriate to writing studies and explore a range of issues and practices that the content metaphor can bring to our professional,…

This study investigates the link between the linguistic principles of implicature and pragmatics and software documentation. When implicatures are created in conversation or text, the listener or reader is required to fill in missing information not overtly stated. This information is usually filled in on the basis of previous knowledge or…

According to research in educational psychology, advance organizers lead to better learning and recall of information. In this research, the authors explored advance organizers from a business perspective, where larger documents are read under time pressure. Graphic and verbal advance organizers were manipulated into six versions of an advisory…

Finds that detection of flaws in a list provides an opportunity to widen perspective on list content, and further opportunity exists when list headings have two meanings. Argues that the list may be represented better by a two-dimensional array. Considers the term "function" used in a list heading, splitting it into its most common…

Argues that technical communication editing is most effective if it deals with structure first, and that structure deficiencies can be detected by applying a range of logical analysis criteria to each text part. Concludes that lists, headings, classifications, and organograms must comply with the laws of categorization and relevant logical…

Focuses on how typography and color complement and differ from each other in signaling an underlying content structure; the synergism between typography, color, and page layout (use of white space) that aids audience understanding and use; and the characteristics of typography and of color that are most important in these contexts. (SR)

Offers guidelines to help novice hypertext designers construct interfaces that are usable. Discusses windows versus frames, which interaction style to use, how to display text and buttons effectively, and how to use color and tables, diagrams, and animation effectively. (SR)

Notes that, although unillustrated text has changed from a string of unseparated words to the paragraph system, text-image relations present a continuous pattern of different degrees of interpretation and structuring for visual understanding. Suggests that human cognitive needs caused an adaptation in unillustrated text and that text illustrations…

Shows how visual images and text differ from one another in the extent to which they resemble their referents; kinds of concepts they evoke; precision with which they evoke them; kinds of structures they impose on the information they convey; and degree to which that information can be interpreted by perceptual as opposed to higher level cognitive…

Argues that all the various genres of documents produced in military research and development formulate some sort of problem. Discusses problem formulation and offers a rhetorical map showing their structural relationships to each other. (SR)

Explores the relation of word and image on the level of both theory and practice in Edward Tufte's "The Visual Display of Quantitative Information." Establishes two dissonant strands in Tufte's work, a positivist strand and a postmodernist strand. (RS)

Weighs the costs and benefits of various strategies for converting existing, formatted text into Standard General Markup Language tagged files for all types of source materials. Illustrates the challenge of converting the implicit structure of tables and other common document features. Gives tips for creating a conversion plan. (SR)

Lists some of the major typographic variables involved in structured abstracts (containing sub-headings). Illustrates how typography can affect clarity by presenting seven examples that illustrate the effects of these typographic variables in practice. Concludes with a final example of an effective approach. (SR)