201E W22 Forrester

ENGL 201E - Genres of Technical Communication

University of Waterloo

Department of English Language and Literature

Instructor: Dr. Clive Forrester

Virtual Class times: Every other Wednesday 1:00-2:20pm via Microsoft Teams Individual consultation: By appointment

Email: clive.forrester@uwaterloo.ca

Course Description

This course is designed to equip participants with the foundational knowledge needed to conceptualize and prepare different styles of technical documents. Since technical writing is far more process-oriented than “regular” academic prose, it is more frequently used in sectors such as business, IT, and publishing. We will draw on examples from these areas and use activities such as role playing and workshopping to design progressively complicated technical documents. Throughout the course, participants will work in groups to design a prototype for a product/service using the technical writing skills developed over the duration of the term.

Learning Outcomes

At the end of the course, participants should be able to:

1. Understand the environment of technical communication
2. Design a “technical brief” for any kind of technical documentation
3. Create a prototype for a client centred service
4. Edit and revise technical writing in a professional manner
5. Convert technical documents for presentation online

Prototyping Projects

The main assessment in this course is centred around the conceptualization, design, and completion of a prototype for a service/product in consultation with a client. All members of the course are assigned to a Team, and each team will be assigned one of the four projects to act as a designer (the Team members will design the prototype), and another project for which they will be a client (the Team members will request the prototype be built for them). In this way, each Team member will get a chance of experiencing both sides of a technical writing project - as a client requesting a service, and as a technical writer designing the user experience for the service. The finished prototype will resemble the “front end” of either a traditional website or app (or a hybrid depending on what the client wants). No coding knowledge will be needed here since the assignment only requires that Teams design a suitable user experience and interface for the service.

Remote Delivery

This course is taught entirely remotely. We will have synchronous meetings via Microsoft Teams on alternate Wednesdays. Attendance at synchronous meetings is recommended but not mandatory. The week, when we do not have our class meetings, should be used for group meetings.Assessment Breakdown: (Detailed instructions and submission guidelines for each assignment can be found on LEARN)

• In-class exercises (20%) [Graded individually]: For each module, short in-class exercises will be assigned. These exercises may either be drawn from the course readings or related to a problem in one of the areas we are covering.
• Participation in document testing (20% - 5% x 4) [Graded individually]: An important aspect of being a technical writer involves being able to work collaboratively. Throughout the course, participants will work in their Teams to create drafts of various aspects of the project prototype and test them with their clients. This is a pass/fail mark that is dependent on your attendance at the document testing exercise. Team members will decide on a meeting time at their convenience.
• Completed Prototype (60% - 15% x 4) [Group grade]: The service prototype is the main assessment for the course. It should conform to the request of your client as closely as possible, and should contain at least the following documentation:
  • A product manual
  • A glossary and FAQ sheet
  • A sample ad copy
  • A help guide and troubleshooting document

Recommended Texts:

(chapters for readings are uploaded to the course LEARN website)

Benyon, David. Designing User Experience: A Guide to HCI, UX and Interaction Design. Harlow, United Kingdom, Pearson Education Limited, 2019. Luecke, R. (2010). Best practice workplace negotiations. American Management Association. USA.

Pringle, A. S., & O’Keefe, S. S. (3rd edition). (2009). Technical writing 101: A real world guide to planning and writing technical content. Scriptorium Publishing Services, Inc. Research Triangle Park, NC, USA.

Smith-Worthington, D. & Jefferson, S. (2011). Technical writing for success. South-Western Cengage Learning. Mason, OH.

Keeping in Touch With Me

The easiest (and recommended) way to contact me is to send me a message via the course MS Teams platform. If I am available, you could likely get a reply in minutes, and we could have a conversation about your question. You should use this medium like you would with email - start with a salutation, such as “Hello Dr. Forrester”, ask your questions, and attach a file if you need to. If for some reason you can’t come to the scheduled office hours, we can make an appointment to meet virtually via Microsoft Teams. Most importantly, do not wait until you feel completely overwhelmed to seek help. Let’s start talking as early as possible.

Academic Integrity

In order to maintain a culture of academic integrity, members of the University of Waterloo community are expected to promote honesty, trust, fairness, respect and responsibility. See the UWaterloo Academic Integrity Webpage (https://uwaterloo.ca/academic-integrity/) and the Arts Academic Integrity Office Webpage (http://arts.uwaterloo.ca/current-undergraduates/academic-responsibility) for more information.