analysis – Technical Writing http://3764f14.tracigardner.com English 3764 @ Virginia Tech – Fall 2014 Wed, 17 Dec 2014 09:19:08 +0000 en-US hourly 1 https://wordpress.org/?v=4.5.3 Peer Review for Project 2 http://3764f14.tracigardner.com/peer-review-for-project-2/ Wed, 24 Sep 2014 04:00:38 +0000 http://3764f14.tracigardner.com/?p=98 Read more →

]]>
This is the post for the September 25, 2014 class meeting.

We will finish this week with peer review for Project 2. Your projects are due on Tuesday, and we’ll begin Project 3, an Informational Report and Proposal on Job Application Needs, on Thursday.

Class Work for September 25

Today we focus on peer review. Here are the tasks to complete for today’s work:

  • Refresh yourself on using the comment system in Google Drive.
  • Post drafts for Project 2 in the forums.
  • Respond to two students on Google Drive and in the forums.
  • Review the comments on your own work.

Important Dates

  • Thursday, Sept 25 by noon: Project 2 Rough Drafts Due for Peer Feedback
  • Tuesday, Sept 30 by 11:55 PM: Project 2: Writing in Your Field Due
  • Tuesday, Oct 7 by 11:55 PM: Project 2: Writing in Your Field Deadline (end of grace period)

Refresher on the Google Drive Comment System

If you need a reminder on the comment and sharing systems in Google Drive, use the step-by-step instructions for how to use Google Drive for peer review on the FAQ site, which includes details on how to share your document, how to comment, and how to respond to comments.  If you need a more detailed explanation, be sure to check out the Lynda video on “Commenting on a file.”

Posting Your Drafts for Project 2

You will post the share link to your draft in the forums:

  1. Go to the Project 2: Analysis of Writing in Your Field forum, and find the topic you created with your name or your username and career or field (e.g., my example was “Traci, college writing instructor”).

  2. Post a reply in your topic, doing the following:
    • If you do not want to share your last name in the forums, change it in your draft to a pseudonym. You can use a generic last name like Doe or Smith, or you can change it to Lastname.
    • Share the link(s) to your Project 2 draft(s) in Google Docs, using the FAQ linked in the section above. You will have a link to your spreadsheet, and if you are going for an A, you will also have a link to your analysis memo.
  3. Let your classmates know about any specific concerns that you want them to consider as they comment on your draft.

  4. Be sure to Preview your draft to make sure everything shows up the way you want it to, and then submit your post.

Responding to Your Classmates’ Drafts

Follow these instructions to respond to your classmates’ drafts:

  1. Read and comment on the drafts of at least two of your classmates:

    • Find one post that no other student has replied to (so that we can be sure everyone gets a reply).
    • Find a second post that has only one other student reply.
  2. Use the Share link to go to your classmate’s draft on Google Drive and do the following:

    • Check the title of the document, and add a comment to tell your partner if it is clear and effective.
    • If you notice any spelling errors, punctuation errors, or typos, mark them as you read, but please focus more on the content rather than editing.
    • Add comments on the content of the draft. Comment on at least three things your classmate does well and at least three things that your classmate could improve on. It’s fine (excellent, even) to include more than the minimum number of comments.
    • If your classmate has included the optional analytical memo, check whether the draft addresses all six characteristics of technical communication. If anything is missing, add a comment that lets your partner know.
  3. Once you finish commenting on the document, go back to your classmate’s post in the forums and add an overall comment that sums up what you thought of the paper and gives your partner some encouragement.

Reviewing the Comments You Received

Once you have finished adding comments to your classmates’ projects, return to your own draft, read the comments that your partner gave you, and add replies as appropriate. For instance, you might thank your partner for catching an error, ask your partner for more detail on feedback you don’t understand, or share a revision and ask your partner if it is an improvement. Your goal is to reply today so that your classmate can respond if you need more information.

]]>
Overview of Project 2: Analysis of Your Field http://3764f14.tracigardner.com/overview-of-project-2-analysis-of-your-field/ Fri, 12 Sep 2014 17:40:10 +0000 http://3764f14.tracigardner.com/?p=81 Read more →

]]>
This is the post for the September 16, 2014 class meeting.

Many of you have already turned in your first project. If you are taking advantage of the grace period, you should have your work in my 11:55 PM on September 18. Today we move on to Project 2.

Class Work for September 16

These are the tasks to complete for today’s work:

  • Go over the assignment for Project 2.
  • Discuss the way design elements are used in technical writing (chapter 7 of Markel).
  • Discuss effective design of email messages in the forum.

Getting Started on Project 2

The second assignment is to analyze the different kinds of writing that you will do in the workplace. You will create a list of kinds of writing and the characteristics that apply to them. Think of your audience for this project as yourself. Your goal is to learn about the characteristics of the kinds of writing you will typically do in the workplace. A year from now, if you were in the workplace, you should be able to come back to this analysis to remind yourself of the kinds of features to include in a text you are writing.

Here’s what I want you to do:

    1. Read the assignment completely. Begin thinking about the goals you will set for the assignment and the specific field you will choose.

    2. If you have any questions (today or in the future) about the assignment, go to the Questions about Project 2 forum and add add a new topic with your question. You can skim through this forum for answers as well.

Design Elements in Technical Writing

Chapter 7 of Markel, “ Designing Documents & Web Sites,” outlines four design principles that you and use to make your writing clearer and easier to read. The secret to remembering them is to rearrange them into a mnemonic: CRAP (Contrast, Repetition, Alignment, and Proximity).

As the chapter explains, you can use various design elements like page layout and headings in your documents. The underlying goal for these elements is to help your audience use the document easily by making key information easy to find and making the document easy to read.

The choice of a spreadsheet for Project 2 demonstrates how design choices can make information more readable and useful to an audience. Spreadsheets (or tables in a Word Processor) are frequently used in the workplace to present information that the audience will compare. For instance, you might create a spreadsheet for benchmarking purposes, to compare different features of competitor’s websites, or to compare contractors for a project to find the best choice.

As you read chapter 7, pay attention to the CRAP design principles, the details on designing documents (such as using layout, columns, and typography), and the information on analyzing page designs.

Discussing Effective Design

Because you have different career goals, you will write different kinds of documents in the workplace. It’s highly likely, however, that all of you will use email to correspond with such varied people as clients, coworkers, managers, vendors, and contractors. I have collected several webpages that talk about how to write email messages that we will use today to talk about effective design.

  1. Visit the following pages and look at how they use design principles and strategies to arrange the information. Make sure you scan through the complete information. For instance, the Forbes article will require you to step through a slide show. Your goal is to scan for design. No need to read every word on the pages.
  2. Visit the Analyzing Document Design (email sites) topic in the forums and talk the way the sites use design. There are some questions there to help you get started.

  3. Aim to add two posts: one with your first impressions upon looking at the sites, and a second one that replies to another person in the class. Read through what others had to say, and reply to one or more of the ideas or questions that your classmates have posted.
]]>