skip to main content
10.1145/3380851.3416749acmconferencesArticle/Chapter ViewAbstractPublication PagesdocConference Proceedingsconference-collections
poster

Addressing the Speculative “You”: Contextualizing the Readers of Documentation

Published:03 October 2020Publication History

ABSTRACT

The poster presents a corpus analysis of a stylistic feature of topic-based documentation: the speculative “you.” The feature signals important information to help readers adapt the content for their situated uses. The feature is illustrated with examples and the author offers recommendations for amplifying this information.

References

  1. J. M. Carroll, The Nurnberg funnel: designing minimalist instruction for practical computer skill. Boston, MA: The MIT Press, 1990.Google ScholarGoogle ScholarDigital LibraryDigital Library
  2. R. Andersen, “Rhetorical work in the age of content management: Implications for the field of technical communication,” Journal of Business and Technical Communication, p. 1050651913513904, 2013.Google ScholarGoogle Scholar
  3. C. Evia, Creating Intelligent Content with Lightweight DITA. New York, NY: Routledge, 2019.V.Google ScholarGoogle Scholar
  4. M. Baker, Every Page is Page One: Topic-Based Writing for Technical Communication and the Web. Laguna Hills, CA: XML Press, 2013.Google ScholarGoogle Scholar
  5. G. Brown and G. Yule, Discourse Analysis. Cambridge University Press, 1983.Google ScholarGoogle ScholarCross RefCross Ref
  6. V. Brezina, P. Weill-Tessier, and A. McEnery,#LancsBox v. 5.x. 2020.Google ScholarGoogle Scholar
  7. D. Biber, B. Douglas, S. Conrad, and R. Reppen, Corpus linguistics: Investigating language structure and use. Cambridge University Press, 2000.Google ScholarGoogle Scholar
  8. H. van der Meij and M. Gellevij, “The four components of a procedure,” IEEE Transactions on Professional Communication, vol. 47, no. 1, pp. 5–14, Mar. 2004, doi: 10.1109/TPC.2004.824292.Google ScholarGoogle ScholarCross RefCross Ref
  1. Addressing the Speculative “You”: Contextualizing the Readers of Documentation

    Recommendations

    Comments

    Login options

    Check if you have access through your login credentials or your institution to get full access on this article.

    Sign in
    • Published in

      cover image ACM Conferences
      SIGDOC '20: Proceedings of the 38th ACM International Conference on Design of Communication
      October 2020
      273 pages
      ISBN:9781450375252
      DOI:10.1145/3380851

      Copyright © 2020 Owner/Author

      Permission to make digital or hard copies of part or all of this work for personal or classroom use is granted without fee provided that copies are not made or distributed for profit or commercial advantage and that copies bear this notice and the full citation on the first page. Copyrights for third-party components of this work must be honored. For all other uses, contact the Owner/Author.

      Publisher

      Association for Computing Machinery

      New York, NY, United States

      Publication History

      • Published: 3 October 2020

      Check for updates

      Qualifiers

      • poster
      • Research
      • Refereed limited

      Acceptance Rates

      Overall Acceptance Rate355of582submissions,61%
    • Article Metrics

      • Downloads (Last 12 months)5
      • Downloads (Last 6 weeks)0

      Other Metrics

    PDF Format

    View or Download as a PDF file.

    PDF

    eReader

    View online with eReader.

    eReader

    HTML Format

    View this article in HTML Format .

    View HTML Format