Journal of Technical Writing and Communication Jul 2002

Extensible Markup Language: How Might it Alter the Software Documentation Process and the Role of the Technical Communicator?

John T. Battalio Boise State University

Abstract

This article describes the influence that Extensible Markup Language (XML) will have on the software documentation process and subsequently on the curricula of advanced undergraduate and master's programs in technical communication. XML, an evolving set of standards for storing and displaying information, uses nine components that make up the XML development process. Grouped into content, formatting, and language specifications, these components enhance organizations' ability to manage information more efficiently and accurately. As the XML development process is adopted, the software documentation process will evolve from a self-contained procedure into a more flexible, interactive process in which software documenters must work closely with a wide range of specialists. The changes that XML will have on the software documentation process will likewise have implications for programs in technical communication in the need to address new kinds of job descriptions, skill sets, and career paths of future technical communicators. The article recommends adaptations to existing courses, as well as new elective and required courses.

Journal
Journal of Technical Writing and Communication
Published
2002-07-01
DOI
10.2190/bdf0-uccp-y5m5-bblb
CompPile
Search in CompPile ↗
Open Access
Closed
Topics
technical communication
Export
BibTeX RIS

Citation Context

Cited by in this index (3)

  1. Battalio (2013)
    Sixteenth- and Seventeenth-Century Falconry Manuals: Technical Writing with a C…
    Journal of Technical Writing and Communication
  2. Stolley (2009)
    Using Microformats: Gateway to the Semantic Web
    IEEE Transactions on Professional Communication
  3. Battalio (2006)
    Teaching a Distance Education Version of the Technical Communication Service Co…
    Journal of Technical Writing and Communication

References (38) · 3 in this index

  1. Souther J. W. (1994)
    Publications Management: Essays for Professional Communicators
  2. Hackos J. T. (1994)
    Managing Your Documentation Projects
  3. Low R. (1994)
    Writing User Documentation: A Practical Guide for Those Who Want To Be Read
  4. Barker T. T. (1998)
    Writing Software Documentation: A Task-Oriented Approach
  5. Brockmann R. J. (1990)
    Writing Better Computer User Documentation: From Paper to Hypertext Version 2.0
Show all 38 →
  1. Woolever K. R. (1994)
    Writing for the Computer Industry
  2. Price J. (1993)
    How To Communicate Technical Information: A Handbook of Software and Hardware Documentation
  3. Grice R. A. (1988)
    Text, ConText, and HyperText: Writing with and for the Computer
     ↗
  4. Weiss E. H. (1991)
    How To Write Usable User Documentation
  5. Brockmann R. J. (1988)
    Text, ConText, and HyperText: Writing with and for the Computer
     ↗
  6. Grice R. (2001)
    Technical Communication
  7. Bolter J. D. (1999)
    Remediation: Understanding New Media
  8. Zimmerman M. (2001)
    Technical Communication
  9. Rockley A. (2001)
    Technical Communication
  10. Extensible Markup Language (XML) 1.0 Second Edition: W3C Recommendation 6 October 2000, 6 October 2000, World…
  11. St. Laurent S. (1999)
    XML: A Primer
  12. Simple Object Access Protocol [SOAP] 1.1: W3C Note 8 May 2000, 8 May 2000, World Wide Web Consortium, 12 Janu…
  13. XML Schema Part 1: Structures: W3C Recommendation 2 May 2001, 2 May 2001, World Wide Web Consortium, 12 Janua…
  14. XML Schema Part 2: Datatypes: W3C Recommendation 02 May 2001, 2 May 2001, World Wide Web Consortium, 12 Janua…
  15. XSL Transformations (XSLT) Version 1.0: W3C Recommendation 16 November 1999, 16 November 1999, World Wide Web…
  16. Cascading Style Sheets, level 1: W3C Recommendation 17 Dec 1996, revised 11 Jan 1999, 11 January 1999, World …
  17. Cascading Style Sheets, level 2, CSS2 Specification: W3C Recommendation 12-May-1998, 12 May 1998, World Wide …
  18. Extensible Stylesheet Language (XSL) Version 1.0: W3C Recommendation 15 October 2001, 15 October 2001, World …
  19. XML Linking Language (XLink) Version 1.0: W3C Recommendation 27 June 2001, 27 June 2001, World Wide Web Conso…
  20. Simpson J. E. (2001)
    Just XML
  21. XML Pointer Language (XPointer) Version 1.0: W3C Candidate Recommendation 11 September 2001, 11 September 200…
  22. XML Path Language (XPath) Version 1.0: W3C Recommendation 16 November 1999, 16 November 1999, World Wide Web …
  23. Carliner S. (2001)
    Technical Communication
  24. Johnson-Eilola et al. (2001)
    Sketching a Framework for Graduate Education in Technical Communication
    Technical Communication Quarterly
  25. (2001)
    SoftQuad: XML Solutions for E-Business
  26. (2001)
    XML Spy
  27. St. Laurent S. (2000)
    XHTML: Moving Toward XML
  28. Rubin J. (1994)
    Handbook of Usability Testing
  29. Barnum C. M. (2002)
    Usability Testing and Research
  30. Battalio (2002)
    A methodology for streamlining historical research: the analysis of technical a…
    IEEE Transactions on Professional Communication
  31. Battalio J. T. (1998)
    The Rhetoric of Science in the Evolution of American Ornithological Discourse
  32. Battalio J. T. (1998)
    Essays in the Study of Scientific Discourse: Methods, Practice, and Pedagogy
  33. Battalio (1996)
    The Interplay between Narrative, Education, and Exposition in an Emerging Science
    Journal of Technical Writing and Communication
CrossRef global citation count: 4 View in citation network → Build reading path →

Related Articles

  1. Written Communication May 2026
    Leveraging Human-Centered Design and Artificial Intelligence to Improve Rural Healthcare: Wicked Problems, Design Thinking, and Mutable Methodologies ↗
    Richard Johnson-Sheehan; Thomas Rickert; Paul Thompson Hunter; Adrianna Deptula
    technical communication artificial intelligence
  2. Journal of Technical Writing and Communication May 2026
    The User Experience of Virtual Reality for Longitudinal Writing: A Diary Study of Immersive Graduate Dissertation Composing Experience ↗
    Jason Tham; Rich Shivener; Niveditha Pookkottuvariam; Sarah Riddick
    rhetorical criticism graduate education technical communication archival research empirical research qualitative research
  3. Journal of Technical Writing and Communication Apr 2026
    Visualizing Heat Risk: Infographics, Memorability, and Design ↗
    Preksha Mysore; Kathryn Lambrecht
    technical communication
  4. Journal of Technical Writing and Communication Apr 2026
    Developing Intercultural Socioemotional Communication Skills: A Hybrid Student Exchange Project Between Kenya, Ireland, and Germany ↗
    Belinda Oechsler; Yvonne Cleary; Sissi Closs
    technical communication professional writing
  5. Journal of Technical Writing and Communication Apr 2026
    What Video Games Can Tell Us About Interactive Technical Communication ↗
    Emily Kuzneski Johnson
    technical communication multimodality