Chapter14 – Technical Writing http://3764s14.tracigardner.com English 3764 @ Virginia Tech – Spring 2014 Tue, 15 Jul 2014 01:52:36 +0000 en-US hourly 1 https://wordpress.org/?v=4.5.3 Reviewing and Revising Definitions http://3764s14.tracigardner.com/reviewing-and-revising-definitions/ Wed, 05 Mar 2014 02:42:19 +0000 http://3764s14.tracigardner.com/?p=327 Read more →

]]>
By popular demand, class for class on Friday, March 7, is an independent, online activity. You need to complete the following steps for credit for attendance and for the in-class writing:

  1. Review the information in the textbook on definitions (pp. 359–366).
  2. Go through the slideshow on Writing Definitions.
  3. Get some practice by using the Writer’s Checklist at the end of Chapter 14 to evaluate the Hokie Speak glossary of terms (use this version on the Wayback Machine if the vt.edu file is 404). This glossary is shared with new employees during orientation. Focus on the terms, which appear at the top of the page, rather than the acronyms at the bottom. You will use the complete Writer’s Checklist on your own text after spring break.
  4. Go to “Tests & Quizzes” in Scholar and complete the day’s assignment, “03/07 Definition Rewrite.” By completing the writing, you will get credit for attendance as well as the credit for the in-class writing. You have until 5 PM on Wednesday, 3/12 to submit your work.

Homework

  • Review your draft before class on Monday, 3/17. Be ready with any questions you have.
  • Be sure you are in class on Monday, 3/17. We will go over how to post your project to the website, and I will explain the class plans for Wednesday, 3/19 and Friday, 3/21. Remember that class will not meet either day, as I will be presenting at the Convention of the Conference on College Composition and Communication in Indianapolis. Office hours will be cancelled for 3/19 and 3/21 as well.
  • Safe travels if you’re leaving town, and no matter what, enjoy your week off.
]]>
Peer Review for Project 2 http://3764s14.tracigardner.com/peer-review-for-project-2/ Tue, 04 Mar 2014 07:22:51 +0000 http://3764s14.tracigardner.com/?p=320 Read more →

]]>
We have two goals for today’s class: doing peer review on rough drafts, and going over the plans for our online class on Friday. Office hours for Friday, March 7 are cancelled.

Online Class Instructions for Friday, March 7

Instead of meeting for class on Friday, March 7, you will review the information about writing definitions and evaluate a glossary of terms that relate to Virginia Tech. You will complete an “in-class” writing that explains your assessment of the glossary and then rewrite the definitions for three of the terms in order to improve them.

By completing the writing, you will get credit for attendance as well as the credit for the in-class writing. The blog post with all the details will go up Wednesday afternoon, by 4 PM on 3/5/2014. You have until 5 PM on Wednesday, 3/12 to submit your work.

Peer Review Instructions for Today

We’re using the same basic set-up that we used for for the first project. You’ll pair up with another student in the classroom, share your Google Docs with each other, and add comments. Please use these instructions to guide the feedback you leave:

  • Imagine that you are your partner’s manager, and your job is to review the draft that your partner has given you and make suggestions to improve it.
  • Check that your partner has included all the required elements in the draft (e.g., technical description, a glossary, and instructions with five images). If anything is missing, add a comment that lets your partner know.
  • Read through the document and comment on at least three things your partner does well and at least three things that your partner could improve. You can comment on more than six things.
  • At the end of the document, add an overall comment that sums up what you thought of the paper and gives your partner some encouragement.
  • Once you have finished adding comments to your partner’s project, return to your own paper, read the comments that your partner gave you, and add replies as appropriate.

In-Class Writing

After you have read the comments on your project and replied, go to “Tests & Quizzes” in Scholar and complete today’s in-class writing, “03/05 Peer Review.” The post is short and easy, but you need to do it to get credit for your work today. You have until 5 PM tomorrow (3/6) to post your response.

Homework

Come back on Wednesday, 3/5/2014, after 4 PM for all the links and details on the activities to complete in place of attending class on Friday, 3/7.

Be sure to attend class on Monday, 3/17 (the Monday after Spring Break) for important details about Project 2 as well as information on the online work due for Wednesday, 3/19, and Friday, 3/21. Class will not meet in the classroom on the 19th or 21st, as I will be presenting at the Convention of the Conference on College Composition and Communication in Indianapolis. Office hours will be cancelled for 3/19 and 3/21 as well.

]]>
Finding, Creating, and Using Graphics http://3764s14.tracigardner.com/finding-creating-and-using-graphics/ http://3764s14.tracigardner.com/finding-creating-and-using-graphics/#comments Mon, 03 Mar 2014 06:00:24 +0000 http://3764s14.tracigardner.com/?p=303 Read more →

]]>
Note: Remember that today is the last day you can drop classes without grade penalty.

Today, we’re talking about graphics. You’ll find lots of useful information in Chapter 8 of Markel, including specifics on how to use different kinds of graphs. We’ll go over some important tips that are relevant for your second project.

Creating (and Choosing) Graphics

Create or choose images that meet these criteria:

  • The graphics need to be free of copyright restrictions (unless they fit the definition of fair use), or you must obtain permission to use them. [More on this topic in the next section.]
  • Photos and/or illustrations should accurately depict the information in the document. Avoid images that are simply decorative.
  • The images should be crisp and well-lit.
  • Garish, clashing, and overly colorful images are a poor choice. Think about the image and the rest of the design on the page as you make a choice.
  • Background noise should be eliminated. There should be nothing irrelevant or distracting in the image. Avoid photobombs!
  • The text should refer to the pictures, and the graphics should work in harmony with the written text.

Finding Graphics You Can Freely Use

Using Graphics

  • If necessary, be sure that your crop and resize your images before you add them to your document.
  • Use the insert tools in the word processor you prefer to place the images on the page. On your Google Drive, look under the Insert menu.
  • Be sure that cite the source for your graphics as well. See pp. 186–187 of the text book for details.

In-Class Writing

We’ll end with the in-class writing. Go to “Tests & Quizzes” in Scholar and complete today’s assignment, “03/03 Choosing Graphics.” As usual, you have until 5 PM tomorrow (3/4) to finish your work.

Homework

  • Have your rough draft available on your Google Drive for peer review on Wednesday, 3/5. You’ll use the instructions in Step One of Using Google Drive for Peer Review to upload your work with a classmate that day.
  • I will also explain the online class work for Friday, 3/7, so be sure you attend so that you know what you need to do!
]]>
http://3764s14.tracigardner.com/finding-creating-and-using-graphics/feed/ 1
Writing Instructions http://3764s14.tracigardner.com/writing-instructions/ Fri, 28 Feb 2014 05:41:41 +0000 http://3764s14.tracigardner.com/?p=289 Read more →

]]>
The third part you need to include in Project 2 is a set of step-by-step instructions for how to complete a task. Your instructions will include a list of required materials, details on the steps to be completed, and any troubleshooting tips or advice. Today we’ll go over how to write this section of your paper.

Homework

Next time we will talk about finding, creating, and using graphics. Please read Markel, Chapter 8 (“Creating Graphics”).

]]>
Writing Descriptions http://3764s14.tracigardner.com/writing-descriptions/ Wed, 26 Feb 2014 07:25:38 +0000 http://3764s14.tracigardner.com/?p=282 Read more →

]]>
You will use technical description to introduce and provide background information on the topic you have chosen for Project 2. Your goal will be to provide the reader with enough information to tell if the document will help her by including background information, explanation, and visual resources. Today, we’ll go over the strategies for writing the description section of your project.

Homework

Next time we will talk about writing instructions so be sure that you have read the section in Markel on that topic (pp. 375-386).

]]>
Writing Definitions http://3764s14.tracigardner.com/writing-definitions/ Mon, 24 Feb 2014 06:29:29 +0000 http://3764s14.tracigardner.com/?p=279 Read more →

]]>
For Project 2, you need to include a glossary of the key terms that relate to the topic that you have chosen. You probably know a great deal about definitions, since most of you have been looking up words in the dictionary since you were very young. Today, we’re going to review strategies for writing definitions, look at some example glossaries, and then end with the in-class writing.

Homework

We will also talk about descriptions (pp. 366–374), so be sure you have read that section of the text.

]]>
Introduction to Project 2 http://3764s14.tracigardner.com/introduction-to-project-2/ Fri, 21 Feb 2014 07:56:20 +0000 http://3764s14.tracigardner.com/?p=271 Read more →

]]>
Today, we begin Project 2, an assignment that asks you to write technical definitions, descriptions, and step-by-step instructions. Markel, Chapter 14 (“Writing Definitions, Descriptions, and Instructions”) will be your best friend as we work on this project. We’ll also return to the information on audience and purpose from Chapter 4, and we’ll look at some relevant information in Chapter 8 (“Creating Graphics”).

Here’s what we’ll do today:

  • I’ll explain the requirements for Project 2, and talk about some changes to the schedule.
  • We’ll brainstorm some potential topics for Project 2, and talk about how to ensure that they are specific enough
  • We’ll find some examples of technical definitions, descriptions, and step-by-step instructions on the Virginia Tech website.
  • We’ll end with the in-class writing. Go to “Tests & Quizzes” in Scholar and complete today’s assignment, “02/21 Major Website Analysis.”

Homework

On Monday, I will ask you to propose your topic for Project 2 for the in-class writing. Spend some time this weekend thinking about possibilities and choose a topic. Think about your specific audience and purpose as they relate to that topic. Return to the information on audience and purpose in Chapter 4 if you need a refresher.

We will also talk about definitions (pp. 358–366), so be sure you have read that section of the text.

]]>