CoChat

Teaching Structured Authoring and DITA Through Rhetorical and Computational Thinking

Evia, Carlos, Sharp, Matthew R., Perez-Quinones, Manuel A. · 2015 · IEEE Transactions on Professional Communication
Cited by 35

The DOI matches its Crossref record; 2 of the 2 references it cites were found in a registry or an index.

Abstract

Background: The diffusion of component content management and structured authoring workflows and technologies in technical communication requires that instructors of documentation courses determine effective ways to teach component content management to students who may initially be intimidated by authoring environments and structures, such as the Darwin Information Typing Architecture (DITA). This teaching case describes how component content management and DITA were integrated into the Creating User Documentation course of an undergraduate professional writing program. Research questions: How can instructors of technical and professional writing best teach English and humanities students to operate within a structured authoring workflow? How can computational abstraction be combined with students' previously acquired genre knowledge to ease their adoption of the DITA to create technical documentation? Situating the case: The development of this course was informed by literature from a variety of scholarly and industry sources, which reveal connections between DITA, computational thinking, and Rhetorical Genre theory. Specifically, the concept of “layers of abstraction” guides the development of the course's structure, allowing students to separate and independently process the various aspects of a structured authoring workflow. How the case was studied: The case was studied informally through the experience of the authors as they developed and taught the course, through informal discussions and structured interviews with industry professionals, and through student reflections from discussion forum posts from Fall 2012 through Fall 2013. About the case: Initially developed with a focus on print manuals and online help, the course began teaching topic-based authoring in the mid-2000s; however, most enterprise-level editors and tools were cost-prohibitive for students and faculty. Furthermore, many computing concepts associated with structured authoring were intimidating for an audience of students in an English department. An affordable solution was adopting the open-source DITA standard, using free trials or open-source editors. The intimidation factor was minimized by designing the course around five layers of abstraction that draw on students' previous rhetorical knowledge: Layer 1: Developing quality documentation, Layer 2: Separating content from design, Layer 3: Authoring granular content with XML, Layer 4: Authoring and linking Component Content Management modules with DITA, and Layer 5: Single-sourcing and content reuse. This case discusses each layer of abstraction, the associated assignments for each layer, and the results of each layer based on student feedback. Results and conclusions: Although the course is not universally loved by students, it has seen many successes and provides a much-needed foundation in component content management and structured authoring for students who might become technical communicators. The teaching team has learned to avoid overemphasizing coding and automation in structured authoring, maintain a solid grounding on writing principles and good technical communication requirements, and draw upon students' existing knowledge of genres and their constraints.

Overview

The claims and statistics of this paper haven’t been checked yet.

Free: it reads the open-access text and checks the first 5 claims that cite a source we can check. Create a free account to check every claim.

A few free checks a day · papers already verified open instantly · results are public

Integrity signals

Registry

Crossref · 10.1109/tpc.2016.2516639

Cites

2 of 2 references verified0 citation errors · 0 not checkable

Statistics

Verification

Claims the paper makes

The claims and statistics of this paper haven’t been checked yet.

Free: it reads the open-access text and checks the first 5 claims that cite a source we can check. Create a free account to check every claim.

A few free checks a day · papers already verified open instantly · results are public

Self-check

Percentages, sums and reported differences re-computed from the paper’s own numbers.

The self-check needs the paper’s full text.

Citations

Cites

Show all 2 references

Cited by

See all 35

Metadata

Authors
Evia, C., Sharp, M. R., & Perez-Quinones, M. A.
Venue
IEEE Transactions on Professional Communication
Published
2015-09
Volume
58
Issue
3
Pages
328-343
ISSN
  • 0361-1434 (ISSN-L)
  • 1558-1500
OpenAlex
W2296417585
Cited by
35
References
2
FWCI
38.19
Type
journal article
Language
en
Open access
closed

About these checks

Registry, retraction, Cites and statistics results are computed, not judged, with one exception: a printed reference that no index lists is read once by a model before it counts as a citation error. Claims are extracted by a model and kept only when their quote appears verbatim in the text; each cited source is then checked, with a model’s help, for whether it says what the claim relies on. Those verdicts can be wrong — read the claim’s quote and the cited source before relying on one.

Statistics and arithmetic are recomputed, not judged.

Confidence bands are shown only for fields calibrated on our annotated test set. None is calibrated yet, so no band is shown.

What counts as a claim ›How we measure confidence ›How we check this ›

Are you an author, or do you see a problem with this page? Request a review

How to cite

Cite CoChat for the checks on this page, and the paper for its own findings.

This page
CoChat. (2026). Citation check: Teaching Structured Authoring and DITA Through Rhetorical and Computational Thinking. https://app.cochat.ai/papers/10.1109/tpc.2016.2516639
The paper
Evia, C., Sharp, M. R., & Perez-Quinones, M. A. (2015). Teaching Structured Authoring and DITA Through Rhetorical and Computational Thinking. IEEE Transactions on Professional Communication. https://doi.org/10.1109/tpc.2016.2516639

Data sources

Bibliographic data: Semantic Scholar, OpenAlex, Crossref.

Contains information from the Semantic Scholar Academic Graph Datasets, made available under the ODC Attribution License (ODC-BY 1.0).

Semantic Scholar’s data is described in: Kinney, R., et al. (2023). The Semantic Scholar Open Data Platform. arXiv:2301.10140.