Apidays Singapore 2024 - Building Digital Trust in a Digital Economy by Veron...
Technical Writing, October 24th, 2013
1.
2. TODAY
1) Checking in with Dr. Anderson
2) Dr. Phill’s advice for making your research
readable
3) Activity: making information user friendly
4) Homework
3. Anderson
Since we last discussed readings, you’ve read chapter
7 and chapter 13 from the Anderson text. As I’ve said
before, Anderson does a great job with the book; I sort
of feel like he nailed it. But let’s review the key points
before we move into some more report-targeted
activities.
4. In Chapter 7, there are 7 guidelines for
research. See how that works? 7 in 7?
8. What?
Research is useless if the data ends up so
dense or so poorly formatted (or
overwhelming) that it cannot be used for the
purposes it is meant to be used for.
This is a biggie. We’re coming back here in a bit for an activity.
10. What?
It used to be just look for “relationships.”
But rhetorically, they need to be meaningful.
Say you have car accident data. There are
two Samoans, and both of them just had
fender benders. NOT really meaningful. But
if there are 45 people under the age of 18,
and all of them wrecked because they were
texting, THAT means something.
12. What?
Why did the two Samoans not mean much?
Because it’s not a statistically relevant
sample.
Why do the 45 youths mean something? 45
participants with the same outcome
indicates high possibility for a one-to-one
relationship.
You need to tell the reader that.
16. What?
We won’t do this until our proposals.
BUT…
To keep our example going, wouldn’t we
suggest finding a way to keep kids from
texting while driving?
18. What?
In a report, you get facts, you give them to
us. If your analysis is bad, you end up
muddying the facts. So… don’t do that! Be
thoughtful, and think through what you’re
doing with the information you find. With
great fact comes great responsibility.
19.
20. So that’s Anderson on reports.
Next up, in chapter 13, he talks to us about
using graphics.
21. Guideline 1: Look for places where graphics
can increase your communication’s
usefulness and persuasion.
22. What?
This was my biggest comment on your
instructions. Sometimes you NEED a photo
or a screenshot. Look for those places.
38. What?
You want to be careful with your
representation of statistics. Real life example:
I saw a report from one of the programs
where I was a student that boasted a 100%
Native American graduation rate: Me. The
huge 100% bar on their graph was JUST ME.
39. So after some Anderson…
The really important, like super key points, from what we
read for the last few days are that you have data that you
will use in your report, but you can’t just go get it and stick it
in the report.
Sort of like how you wouldn’t get ground beef, cans of
tomatoes and beans, an onion, some peppers and various
spices and chuck them on the table (you’d make chili!), you
don’t just throw raw data at people. That’s why we call it raw
data. Cook it!
42. You’re going to have a plethora of data. Of
datai? Of datasususus?
Anyway…
The goal is to only relate to the reader what
she needs. If you’re researching the safest
cars for families, the data sheet might
include the colors it comes in. Not
important. Cut the fat!
44. To continue the metaphor…
If you see raw chicken, Ragu sauce, a block of
cheese, bread crumbs, eggs, and a box of
spaghetti sitting on my counter…
You don’t expect I’m going to serve you
meatloaf, right?
45. A secret: humans are pattern recognizing
machines. So use that when organizing your
data.
Sequence things in ways that make
arguments already.
The Mercedes C is best in class, five star
safety rating. It has 20 airbags. It has
dynamic anti-lock brakes. It’s made of win.
(see how a case is being made with the data?)
47. Sometimes data is just overwhelming.
Information is everywhere, and thanks to
technology, we generate even more of it
each and every second. While I was talking
just now, more data flew into existence.
Sometimes you need to carve out just the
right pieces.
48. An example: if you’ve been following the
“debates” about the Affordable Care Act
(AKA Obamacare), there are claims– data
points, as individuals talk and write– that it
is KILLING small businesses.
49. But if you take an actual example, there’s a
man who was on FOX news last night. He
employs 4 people. He claims that Obamacare
“means I can’t hire more employees.”
50. The ACA states that at over 50 employees,
an employer must kick in insurance. So that
guy would have to expand by 47 employees
to be hurt.
51. Ergo, taken as a chopped out piece, this data
doesn’t say what it said. But we had to cut
around it to find that.
54. Imagine it in writing.
Reports show that Washington state had
seven percent unemployment, while
Montana had five (repeat with new number
48X).
All the data is on that map. But we can chew
on that. Write it in paragraph form and I’ll
break into hives.
55. So…
Sadly, there’s no set recipe for “report.” That’s why
we’ve been looking at audiences and expectations and
such.
There is, however, for our class activity!
On the course website there are links to two documents from
Apple: The data sheet for the original iPad and the data sheet
for the brand new iPad Air. Please pair up with someone, get
to a computer, and open those links.
56. The activity
Pretend for this activity Dr. Phill runs a writing center that
owns 10 original iPads for student use.
Your job is to explain to me in the report– and we just need a
data treatment for this activity, not the whole report– the
upgrades from the original model to the new model.
Think about what we talked about today as you treat the
data.
57. When you finish treating the data
Email it to me.
For Tuesday, read Anderson, Chapter 14.
Remember your case study is due via email on Tuesday.
Have a good weekend! Stay warm!