Document Makeover
The Document Makeover is the first major module in Professional Writing, which is an undergraduate course on workplace writing. See the schedule to understand how this project fits into the course. |
The overarching goals of The Document Makeover are to help you think about
- memo writing conventions
- rhetorical principles,
- especially the importance of rhetorical analysis and audience in professional and technical writing
- the importance of document usability and accessibility
- document revision and style, especially the attributes of a Technical Writing Prose Style* as opposed to an Academic Prose Style and a reader-based prose style as opposed to a writer-based prose style.
More specifically, students reflect on and better understand
- how the rhetorical context, particularly a change in exigency and audience, shape how and what one writes
- how the needs of particular readers (e.g., people with special accommodations) influence design
- how to revise and redesign a document based on stylistic principles, including
Key Terms: Usability Analysis, Rhetorical Analysis, Design
Overview of the Module
Welcome to Module 1 for Professional Writing.
By the time you’ve completed this module, you’ll be able to
- Analyze the audiences, purposes, and context for an existing document
- Apply technical editing skills to an existing document
- Apply basic document design and text formatting
- Create documents that are accessible for readers/users with one or more access challenges
- Report on your own learning progress following memo conventions
Deliverables
This module has four deliverables:
- A copy of the syllabus you are revising (PDF or screenshots).
- A Rhetorical Analysis Memo
- A redesigned, revised, and edited syllabus that demonstrates some mastery of a Technical Writing Prose Style*
- A Project Completion Memo
Summary of Project Tasks
- Locate a syllabus that is not as user-friendly and useful as it could be in terms of meeting the exigencies of our current situation—COVID 19
- Think broadly about the syllabus as a genre of discourse. Consider your past experiences reading syllabi. Read the brief note on syllabi as a genre of discourse. Search the internet for syllabi on topics of interest.
- Engage in rhetorical analysis
- Review the Heuristic Exercise for The Document Makeover
- Reflect on the challenges that our new context – online delivery of classes – poses for the syllabus target audience, and work to understand – especially – how the change in context might affect readers/users who have access challenges, such as low vision, mobility impairment, etc.
- Review the Home Office’s Designing for Accessibility Posters and consider redesigning, revising, and editing a syllabus to better meet the needs of one or more of the audience-types identified by the Home Office Posters.
- Consider the Heuristic Exercise for The Document Makeover to help stimulate your thinking about this exercise.
- Write a Rhetorical Analysis Memo to your instructor analyzing the rhetorical situation.
- Review Professional Writing Guidelines for the Document Makeover. Revise, edit, and redesign the original document (the syllabus) for the new audience and context.
- Compose a Project Completion Memo, and turn in the original and made-over versions of the syllabus and your project completion memo.
Introduction to the Document Markover
Thanks to COVID 19, schools are undergoing a remarkable, sudden shift from face-to-face to online teaching. As a result of COVID, our context as students, as readers and users of academic texts including the course syllabus, has changed dramatically.
As a writer of academic texts, you’re probably used to writing texts for audiences that are primarily readers. You can expect that when you turn in an assignment, your intended audience will read every word from beginning to end. But the audiences for workplace writing may be both readers and users. That is, they may have to interact with your document in some way. For example, students may want to read the syllabus for an online class onscreen on their cell phone, tablet, or laptop, or download it and print it out.
For this project, we’ll focus not only on revising the content and redesigning the layout to meet reader’s information needs; we’ll also focus on meeting the particular access needs of a specific user group (or groups).
Ultimately, you can choose the new audience for your document makeover. For instance, if you are an international student studying in the U.S., you could revise the syllabus for high school (or its equivalent) students back home.
That said, to make this project as easy as possible, we recommend that you redesign a syllabus for one of the audiences described by the Home Office in its Designing for Accessibility Posters:
- users on the autistic spectrum
- users who will read solely online, maybe only via phone
- users with low vision
- users with dyslexia
- users with physical or motor disabilities
- users who are deaf or hard of hearing
It is essential that readers and users of your workplace documents can physically access, read, and interact with your documents without regard to physical abilities or challenges. For this project, you’ll analyze the changes in that context, the purposes and functions of the syllabus, and the particular needs of students who are learning online.
Grading
You will receive one holistic grade based on the four deliverables.
The revised document will be evaluated for these features:
- Effective use of a reader-centered approach and professional and technical writing stylistic principles
- Edited for precision and professional style, including
- clear, informative titles, headings, and subheadings
- clear, informative paragraphs
- strong, effectively structured sentences
- tone, level of formality, word choice appropriate to target audience.
- Effective use of basic information design principles, including using
- chunking, queuing, and filtering to help readers navigate
- application of page grids and adequate white space
- effective typography (including line length and line spacing) appropriate to audience and purpose
- Effective use of the technical writing formatting:
- Text formatting
- Lists and hyperlinks
- Page layout
- Headers and footers
- Page numbers
- Headings and subheadings (using Styles)
- Visual elements: Images, shapes, tables and/or charts
- Edited for precision and professional style, including
- Effective revisions/edits.
The project completion memo will be evaluated for these features:
- Presentation of complete, clear, concise, compelling information appropriate to audience, purpose, and setting
- Effective use of a reader-centered approach, edited for precision and professional style.
- Meets reader expectations for the memo genre.