Written Communication Oct 2022

Uses of Metadiscourse in Online Help

Jason Swarts North Carolina State University

Abstract

Metadiscourse guides how readers interact with a text and process the information they find. Because texts differ in purpose and audience, so do patterns of metadiscourse use. This research examines the patterns of metadiscourse use in topic-based writing, developed following a structured authoring method. The resulting writing is modular, nonhierarchical, and nonlinear, which creates user experience issues related to attention as well as information selection, ordering, processing, and navigation. The patterns of language use in topic-based writing reveal how metadiscourse might help readers address these reader experience issues.

Journal
Written Communication
Published
2022-10-01
DOI
10.1177/07410883221109241
CompPile
Search in CompPile ↗
Open Access
Closed
Export
BibTeX RIS

Citation Context

Cited by in this index (0)

No articles in this index cite this work.

References (60) · 10 in this index

  1. Albers M. (2003)
    Technical Communication
  2. 10.1145/1456536.1456560
     ↗
  3. 10.1145/1621995.1622027
     ↗
  4. Amazon. (2021). Elastic compute cloud documentation. Retrieved July 14, 2021, from https://docs.aws.amazon.co…
  5. Ament K. (2003)
    Single sourcing: Building modular documentation
Show all 60 →
  1. Andersen et al. (2015)
    The Current State of Component Content Management: An Integrative Literature Review
    IEEE Transactions on Professional Communication
  2. Archer D. (2009)
    What’s in a word-list?: Investigating word frequency and keyword extraction
  3. Baehr C. (2019)
    Technical Communication
  4. Bailie et al. (2015)
    The Effect of CMS Technology on Writing Styles and Processes: Two Case Studies
    IEEE Transactions on Professional Communication
  5. Baker M. (2013)
    Every page is page one: Topic-based writing for technical communication and the web
  6. Barker T. T. (2003)
    Writing software documentation
  7. BEAUVAIS (1989)
    A Speech Act Theory of Metadiscourse
    Written Communication
  8. Bellamy L. (2012)
    DITA best practices: A roadmap for writing, editing, and architecting in DITA
  9. 10.1093/llc/8.4.243
     ↗
  10. Biber D. (2000)
    Corpus linguistics: Investigating language structure and use
  11. Boettger et al. (2014)
    The Naked Truth about the NakedThis: Investigating Grammatical Prescriptivism i…
    Technical Communication Quarterly
  12. 10.1017/9781316410899
     ↗
  13. Brezina V., Weill-Tessier P., McEnery A. (2020). #LancsBox v. 5.x. http://corpora.lancs.ac.uk/lancsbox
  14. Carradini (2018)
    An Organizational Structure of Indie Rock Musicians as Displayed by Facebook Usage
    Journal of Technical Writing and Communication
  15. Carroll J. M. (1990)
    The Nurnberg funnel: Designing minimalist instruction for practical computer skill
  16. Cisco. (2021). Container platform 7.0.0 user guide. Cisco. Retrieved July 14, 2021, from https://www.cisco.co…
  17. 10.1007/978-3-642-39715-8_4
     ↗
  18. Crismore A. (1989)
    Talking with readers: Metadiscourse as rhetorical act
  19. CRISMORE et al. (1993)
    Metadiscourse in Persuasive Writing: A Study of Texts Written by American and F…
    Written Communication
  20. 10.4324/9780429059612-8
     ↗
  21. Dush (2015)
    When Writing Becomes Content
    College Composition and Communication
  22. 10.5040/9781350023857.0010
     ↗
  23. Erickson L. (2019). The role of taxonomy and search in content usability. https://epub.fh-joanneum.at/obvfhjh…
  24. Evia C. (2019)
    Creating intelligent content with lightweight DITA
  25. 10.37514/PRA-B.2019.0230
     ↗
  26. Hardie A. (2014). Log ratio – an informal introduction. ESRC Centre for Corpus Approaches to Social Science (…
  27. 10.21236/AD0699201
     ↗
  28. Horton W. (1994)
    Designing and writing online documentation
  29. 10.1016/S0378-2166(98)00009-5
     ↗
  30. Hyland K. (2005)
    Metadiscourse: Exploring interaction in writing
  31. 10.1016/j.pragma.2017.03.007
     ↗
  32. James W. (2019)
    Essays in radical empiricism
  33. Jonsson E. (2002)
    Inner navigation: Why we get lost in the world and how we find our way
  34. Kaufer D. (2011)
    Applied Natural Language Processing and Content Analysis: Advances in Identification, Inv…
  35. Kaufer et al. (2016)
    Analyzing the Language of Citation across Discipline and Experience Levels: An …
    Journal of Writing Research
  36. Lanham R. A. (2006)
    The economics of attention: Style and substance in the age of information
  37. Microsoft. (2021). Azure documentation. Retrieved July 14, 2021, from https://docs.microsoft.com/en-us/azure/
  38. Oracle. (2021). Container engine for Kubernetes [Topic]. Retrieved July 14, 2021, from https://docs.oracle.co…
  39. 10.1093/acprof:oso/9780195173321.001.0001
     ↗
  40. 10.1145/223904.223911
     ↗
  41. 10.1007/978-3-030-58163-3_6
     ↗
  42. Priestley M. (2001)
    Technical Communication
  43. 10.17265/2159-5313/2016.09.003
     ↗
  44. RedHat/IBM. (2021). OpenShift documentation. Retrieved July 14, 2021, from https://docs.openshift.com/
  45. Redish J. C. (1993)
    Techniques for technical communicators
  46. Robidoux (2007)
    Rhetorically Structured Content: Developing a Collaborative Single-Sourcing Cur…
    Technical Communication Quarterly
  47. Rockley A. (2012)
    Managing enterprise content: A unified content strategy
  48. Rosenfeld L. (2002)
    Information architecture for the World Wide Web
  49. Sapienza (2007)
    A Rhetorical Approach to Single-Sourcing Via Intertextuality
    Technical Communication Quarterly
  50. 10.1016/S0346-251X(97)00011-0
     ↗
  51. Scott M. (2009)
    What’s in a word-list?
  52. 10.7330/9781607327622
     ↗
  53. Vande Kopple W. J (2002)
    Discourse Studies in Composition
  54. Weiss E. H. (1991)
    How to write usable user documentation
  55. 10.7208/chicago/9780226263410.001.0001
     ↗
CrossRef global citation count: 0 View in citation network → Build reading path →