Tracy's blog 7: document design and technical marketing documents

Technical marketing documents are produced with specific attention paid to document design. As we discussed last week in relation to rhetoric and technical marketing documents, writers and designers make a series of key decisions related to the product, the manufacturer, target audiences, availability of resources used to produce the document, and the document’s point of distribution.

Document design: the basics

Technical Marketing Materials Project: proposals

Now that we've spent the past couple of weeks with the Technical
Marketing Materials Project, you likely have a pretty good idea of what
kind of product you're going to work with, and of the approach you're
going to take with it. Now it's time to put your plans in writing, via
the project proposal.

Proposals for the Technical Marketing Materials Project should be
750 words, single-spaced, in length and incorporate/address the
following items:

Technical Marketing Project: group assignments

Here are the group assignments for the Technical Marketing Project:

10:30 class

Group 1

  • Sam Chumbley
  • Mark Eads
  • Luke Hetterscheidt
  • Ryan Rayl

Group 2

  • Laura deVries
  • Emily Pohlman
  • Eric Robinson
  • Michael Muenich

Group 3

  • Sean McManus
  • Corie Profilovich
  • Jonathan Warus
  • Daniel Zeller

Group 4

White Paper Project: draft 2 assignment details

I've presented this information in class, but for convenience's
sake I'll do so here, as well.

Tracy's blog 6b: white paper conclusions

After reading through first drafts of the white paper, I've decided to focus today's "lecture notes" on writing effective conclusions.

For a document like the white paper -- which will run at least 10
pages by the time you submit Draft 4, and has a distinct persuasive
bent to it -- conclusions need to be more focused and detailed than a
one-paragraph "restate the introduction and sum it up" affair. They
need to run two paragraphs at the absolute minimum, and three would be
even better.

Tracy's blog 6: white paper research, revisited

Since you're about to submit Draft 2 of the white paper, I would like to direct your attention to items we discussed a couple of weeks ago related to research -- especially emphasis on including several types of professionally-oriented sources. When doing research for a document that is as professionally-based and topic/audience-driven as a white paper generally is, it's essential to your white paper's overall success that your research activities are both extensive and intensive. Give

Tracy's blog 5: suggested white paper structure, content/approach

Listed below is a suggested format for your white paper. This covers both length and content:

General structure of white papers

Executive summary: This section is usually 1-3 paragraphs in length, and provides a general outline for the white paper. It will present the paper’s position, and often discuss research methodologies used.

Tracy's blog 4: sample annotated bibliography

Here's a sample annotated bibliography. You'll see that I followed the same basic format for each entry: bibliographic entry first (sequenced in alphabetical order), followed by a 50-100 word annotation in which I describe the information presented within that source, analyze the significance of that information, and assess that source's usability where my hypothetical project is concerned.

Tracy's blog 3: (re-)visiting some important open-source-related issues/questions

Last Tuesday's readings explored the the open source movement, its origins, and how it relates those proprietary options more recognizable to us -- namely, Microsoft and Microsoft products. Here are some issues/questions that you may have considered, along with some issues that we will consider at some point during the course of the White Paper Project:

Documentation for labeling screenshots in Microsoft Word 2007

I've created documentation for labeling screenshots that's more specific to Microsoft Word 2007. Access it here:

http://www.digitalparlor.org/sp08/clark1/sites/digitalparlor.org.sp08.clark1/files/screenshotlabel2007.doc 

In the meantime, good luck with further revising your quick guides!