iCFP: Tolerating All Level Cache Misses in In-Order Processors
Writing Forensic Reports · 2016. 11. 29. · A workshop developed for ICFP by Karen Gray Writing...
Transcript of Writing Forensic Reports · 2016. 11. 29. · A workshop developed for ICFP by Karen Gray Writing...
![Page 1: Writing Forensic Reports · 2016. 11. 29. · A workshop developed for ICFP by Karen Gray Writing Forensic Reports . Put it before them briefly so they will read it, clearly so they](https://reader036.fdocuments.us/reader036/viewer/2022071216/6048c8787a82643de35b9470/html5/thumbnails/1.jpg)
A workshop developed for ICFP
by
Karen Gray
Writing Forensic
Reports
![Page 2: Writing Forensic Reports · 2016. 11. 29. · A workshop developed for ICFP by Karen Gray Writing Forensic Reports . Put it before them briefly so they will read it, clearly so they](https://reader036.fdocuments.us/reader036/viewer/2022071216/6048c8787a82643de35b9470/html5/thumbnails/2.jpg)
Put it before them briefly so they
will read it, clearly so they will
appreciate it, picturesquely so they
will remember it, and above all,
accurately so they will be guided by
its light.
Joseph Pulitzer – 19th century
journalist and newspaper
publisher
![Page 3: Writing Forensic Reports · 2016. 11. 29. · A workshop developed for ICFP by Karen Gray Writing Forensic Reports . Put it before them briefly so they will read it, clearly so they](https://reader036.fdocuments.us/reader036/viewer/2022071216/6048c8787a82643de35b9470/html5/thumbnails/3.jpg)
Practical tips for
Punctuation
Vocabulary
Verbs
Planning
Reviewing
![Page 4: Writing Forensic Reports · 2016. 11. 29. · A workshop developed for ICFP by Karen Gray Writing Forensic Reports . Put it before them briefly so they will read it, clearly so they](https://reader036.fdocuments.us/reader036/viewer/2022071216/6048c8787a82643de35b9470/html5/thumbnails/4.jpg)
USE PUNCTUATION TO
MAKE YOUR POINT
![Page 5: Writing Forensic Reports · 2016. 11. 29. · A workshop developed for ICFP by Karen Gray Writing Forensic Reports . Put it before them briefly so they will read it, clearly so they](https://reader036.fdocuments.us/reader036/viewer/2022071216/6048c8787a82643de35b9470/html5/thumbnails/5.jpg)
![Page 6: Writing Forensic Reports · 2016. 11. 29. · A workshop developed for ICFP by Karen Gray Writing Forensic Reports . Put it before them briefly so they will read it, clearly so they](https://reader036.fdocuments.us/reader036/viewer/2022071216/6048c8787a82643de35b9470/html5/thumbnails/6.jpg)
Abbreviations
Which is correct?
SAA or S.A.A.
Mr or Mr.
etc or etc.
ie or i.e.
eg or e.g.
SAA
Mr
etc
ie
eg
![Page 7: Writing Forensic Reports · 2016. 11. 29. · A workshop developed for ICFP by Karen Gray Writing Forensic Reports . Put it before them briefly so they will read it, clearly so they](https://reader036.fdocuments.us/reader036/viewer/2022071216/6048c8787a82643de35b9470/html5/thumbnails/7.jpg)
Acronyms
SMART
UNISA
Aids
golf
posh
scuba
![Page 8: Writing Forensic Reports · 2016. 11. 29. · A workshop developed for ICFP by Karen Gray Writing Forensic Reports . Put it before them briefly so they will read it, clearly so they](https://reader036.fdocuments.us/reader036/viewer/2022071216/6048c8787a82643de35b9470/html5/thumbnails/8.jpg)
DATE AND
TIME CONVENTIONS
Date format:
2016 – 11 -23 (ISO8601)
21 November 2016 (letters and emails) eg I will see you on 23 November 2016
Time format:
13:20 (ISO8601)
![Page 9: Writing Forensic Reports · 2016. 11. 29. · A workshop developed for ICFP by Karen Gray Writing Forensic Reports . Put it before them briefly so they will read it, clearly so they](https://reader036.fdocuments.us/reader036/viewer/2022071216/6048c8787a82643de35b9470/html5/thumbnails/9.jpg)
Bullet points today
Our discussions included:
Potential fuel sources
Use for thermal loads
Locations of high energy usage
Areas of wasted energy
Suitability of technology
![Page 10: Writing Forensic Reports · 2016. 11. 29. · A workshop developed for ICFP by Karen Gray Writing Forensic Reports . Put it before them briefly so they will read it, clearly so they](https://reader036.fdocuments.us/reader036/viewer/2022071216/6048c8787a82643de35b9470/html5/thumbnails/10.jpg)
Bullets - traditional rule #1
Every policy owner is responsible for the following:
Policy drafting
Stakeholder input
Document finalisation
No full stops necessary – points are not sentences.
![Page 11: Writing Forensic Reports · 2016. 11. 29. · A workshop developed for ICFP by Karen Gray Writing Forensic Reports . Put it before them briefly so they will read it, clearly so they](https://reader036.fdocuments.us/reader036/viewer/2022071216/6048c8787a82643de35b9470/html5/thumbnails/11.jpg)
Bullets - traditional rule #2
The responsibilities of the policy owner are as follows:
A draft policy document is to be prepared.
Input must be obtained from the various stakeholders.
The final draft of the policy document has to be written.
Bullets are full sentences so full stops necessary.
![Page 12: Writing Forensic Reports · 2016. 11. 29. · A workshop developed for ICFP by Karen Gray Writing Forensic Reports . Put it before them briefly so they will read it, clearly so they](https://reader036.fdocuments.us/reader036/viewer/2022071216/6048c8787a82643de35b9470/html5/thumbnails/12.jpg)
Bullets traditional rule #3
The policy owner is responsible for:
preparing a draft policy document;
obtaining input from the various stakeholders; and
updating the document if there are any changes.
Each bullet completes the stem sentence and begins with a GERUND. Use
a semi-colon and ‘and’ before last bullet.
![Page 13: Writing Forensic Reports · 2016. 11. 29. · A workshop developed for ICFP by Karen Gray Writing Forensic Reports . Put it before them briefly so they will read it, clearly so they](https://reader036.fdocuments.us/reader036/viewer/2022071216/6048c8787a82643de35b9470/html5/thumbnails/13.jpg)
Bullets -traditional rule #4
The policy owner is responsible for the following:
Preparing a draft policy document.
Obtaining input from the various stakeholders.
Updating the document if there are any changes.
Bullets are gerundial phrases. They do not complete the stem
sentence. Use upper case to show each is a complete thought.
![Page 14: Writing Forensic Reports · 2016. 11. 29. · A workshop developed for ICFP by Karen Gray Writing Forensic Reports . Put it before them briefly so they will read it, clearly so they](https://reader036.fdocuments.us/reader036/viewer/2022071216/6048c8787a82643de35b9470/html5/thumbnails/14.jpg)
Bullet points in practice
Our discussions included:
Potential fuel sources
Use for thermal loads
Locations of high energy usage
Areas of wasted energy
Suitability of technology
![Page 15: Writing Forensic Reports · 2016. 11. 29. · A workshop developed for ICFP by Karen Gray Writing Forensic Reports . Put it before them briefly so they will read it, clearly so they](https://reader036.fdocuments.us/reader036/viewer/2022071216/6048c8787a82643de35b9470/html5/thumbnails/15.jpg)
![Page 16: Writing Forensic Reports · 2016. 11. 29. · A workshop developed for ICFP by Karen Gray Writing Forensic Reports . Put it before them briefly so they will read it, clearly so they](https://reader036.fdocuments.us/reader036/viewer/2022071216/6048c8787a82643de35b9470/html5/thumbnails/16.jpg)
Numbered points
There are three applications for
this technology:
1. The insurance industry.
2. The Defence Force.
3. The pharmaceutical industry.
![Page 17: Writing Forensic Reports · 2016. 11. 29. · A workshop developed for ICFP by Karen Gray Writing Forensic Reports . Put it before them briefly so they will read it, clearly so they](https://reader036.fdocuments.us/reader036/viewer/2022071216/6048c8787a82643de35b9470/html5/thumbnails/17.jpg)
Colon
![Page 18: Writing Forensic Reports · 2016. 11. 29. · A workshop developed for ICFP by Karen Gray Writing Forensic Reports . Put it before them briefly so they will read it, clearly so they](https://reader036.fdocuments.us/reader036/viewer/2022071216/6048c8787a82643de35b9470/html5/thumbnails/18.jpg)
Semicolon
To be born a gentleman
is an accident;
to die a gentleman is an
achievement.
![Page 19: Writing Forensic Reports · 2016. 11. 29. · A workshop developed for ICFP by Karen Gray Writing Forensic Reports . Put it before them briefly so they will read it, clearly so they](https://reader036.fdocuments.us/reader036/viewer/2022071216/6048c8787a82643de35b9470/html5/thumbnails/19.jpg)
Apostrophes - possession
John’s books
The boys’ books
BUT
Thomas’s books
![Page 20: Writing Forensic Reports · 2016. 11. 29. · A workshop developed for ICFP by Karen Gray Writing Forensic Reports . Put it before them briefly so they will read it, clearly so they](https://reader036.fdocuments.us/reader036/viewer/2022071216/6048c8787a82643de35b9470/html5/thumbnails/20.jpg)
DON’T use apostrophes to form
plurals!
![Page 21: Writing Forensic Reports · 2016. 11. 29. · A workshop developed for ICFP by Karen Gray Writing Forensic Reports . Put it before them briefly so they will read it, clearly so they](https://reader036.fdocuments.us/reader036/viewer/2022071216/6048c8787a82643de35b9470/html5/thumbnails/21.jpg)
CHOOSE SIMPLE, SPECIFIC WORDS
FOR PRECISE MEANING
![Page 22: Writing Forensic Reports · 2016. 11. 29. · A workshop developed for ICFP by Karen Gray Writing Forensic Reports . Put it before them briefly so they will read it, clearly so they](https://reader036.fdocuments.us/reader036/viewer/2022071216/6048c8787a82643de35b9470/html5/thumbnails/22.jpg)
Over to you
Can you spot the errors in the
activity on page 15?
Good luck!
![Page 23: Writing Forensic Reports · 2016. 11. 29. · A workshop developed for ICFP by Karen Gray Writing Forensic Reports . Put it before them briefly so they will read it, clearly so they](https://reader036.fdocuments.us/reader036/viewer/2022071216/6048c8787a82643de35b9470/html5/thumbnails/23.jpg)
USING THE RIGHT WORDS
We only recently became aware of this specification.
We find ourselves in a unique situation.
This is the better of the two cars.
The machine broke down frequently.
The prize money was divided amongst the three winners.
Inform your clients about our referral programme.
I applied to the licensing department for a driving licence.
There were fewer spectators yesterday at cricket than there were last week.
The doctor’s tone implied the patient’s condition was critical.
I SMSed my results to the committee.
![Page 24: Writing Forensic Reports · 2016. 11. 29. · A workshop developed for ICFP by Karen Gray Writing Forensic Reports . Put it before them briefly so they will read it, clearly so they](https://reader036.fdocuments.us/reader036/viewer/2022071216/6048c8787a82643de35b9470/html5/thumbnails/24.jpg)
And remember, to
write well, always
prefer the short
vocable to the
sesquipedalian…
![Page 25: Writing Forensic Reports · 2016. 11. 29. · A workshop developed for ICFP by Karen Gray Writing Forensic Reports . Put it before them briefly so they will read it, clearly so they](https://reader036.fdocuments.us/reader036/viewer/2022071216/6048c8787a82643de35b9470/html5/thumbnails/25.jpg)
Prefer the
short word to
the long word.
![Page 26: Writing Forensic Reports · 2016. 11. 29. · A workshop developed for ICFP by Karen Gray Writing Forensic Reports . Put it before them briefly so they will read it, clearly so they](https://reader036.fdocuments.us/reader036/viewer/2022071216/6048c8787a82643de35b9470/html5/thumbnails/26.jpg)
What is technical jargon?
Words or expressions used by a
particular profession or group
that are difficult for others to
understand.
Oxford South African Dictionary
![Page 27: Writing Forensic Reports · 2016. 11. 29. · A workshop developed for ICFP by Karen Gray Writing Forensic Reports . Put it before them briefly so they will read it, clearly so they](https://reader036.fdocuments.us/reader036/viewer/2022071216/6048c8787a82643de35b9470/html5/thumbnails/27.jpg)
![Page 28: Writing Forensic Reports · 2016. 11. 29. · A workshop developed for ICFP by Karen Gray Writing Forensic Reports . Put it before them briefly so they will read it, clearly so they](https://reader036.fdocuments.us/reader036/viewer/2022071216/6048c8787a82643de35b9470/html5/thumbnails/28.jpg)
Rules of thumb for jargon
Does the jargon add meaning?
No?
BIN IT!
![Page 29: Writing Forensic Reports · 2016. 11. 29. · A workshop developed for ICFP by Karen Gray Writing Forensic Reports . Put it before them briefly so they will read it, clearly so they](https://reader036.fdocuments.us/reader036/viewer/2022071216/6048c8787a82643de35b9470/html5/thumbnails/29.jpg)
Rules of thumb for
jargon
Ask yourself:
Would you
ever say this
to someone?
No?
Bin it!
![Page 30: Writing Forensic Reports · 2016. 11. 29. · A workshop developed for ICFP by Karen Gray Writing Forensic Reports . Put it before them briefly so they will read it, clearly so they](https://reader036.fdocuments.us/reader036/viewer/2022071216/6048c8787a82643de35b9470/html5/thumbnails/30.jpg)
Over to you
Please be advised that there is a deadline for registration, which should be noted and strictly adhered to.
The deadline for registration is 30 June 2016.
Should you have any further queries, please do not hesitate to contact me as per my details below.
Please let me know if you have any further queries.
It has come to my attention that various items of equipment are missing from the media room.
Various items of equipment are missing from the media room.
![Page 31: Writing Forensic Reports · 2016. 11. 29. · A workshop developed for ICFP by Karen Gray Writing Forensic Reports . Put it before them briefly so they will read it, clearly so they](https://reader036.fdocuments.us/reader036/viewer/2022071216/6048c8787a82643de35b9470/html5/thumbnails/31.jpg)
More jargon
Our previous meeting refers. As mentioned, XYZ
will be managing this process going forward.
As we discussed yesterday, XYZ will manage this
process in future.
Attached please find the complete documentation
for your kind attention as requested.
I have attached the documents as you requested.
![Page 32: Writing Forensic Reports · 2016. 11. 29. · A workshop developed for ICFP by Karen Gray Writing Forensic Reports . Put it before them briefly so they will read it, clearly so they](https://reader036.fdocuments.us/reader036/viewer/2022071216/6048c8787a82643de35b9470/html5/thumbnails/32.jpg)
Where is our language going
to?
2015 Word of the Year
![Page 33: Writing Forensic Reports · 2016. 11. 29. · A workshop developed for ICFP by Karen Gray Writing Forensic Reports . Put it before them briefly so they will read it, clearly so they](https://reader036.fdocuments.us/reader036/viewer/2022071216/6048c8787a82643de35b9470/html5/thumbnails/33.jpg)
“
”
Emojis are no longer the
preserve of texting teens –
instead they have been
embraced as a nuanced form of
expression … which can cross
language barriers.
Oxford Words Blog
16 November 2015
![Page 34: Writing Forensic Reports · 2016. 11. 29. · A workshop developed for ICFP by Karen Gray Writing Forensic Reports . Put it before them briefly so they will read it, clearly so they](https://reader036.fdocuments.us/reader036/viewer/2022071216/6048c8787a82643de35b9470/html5/thumbnails/34.jpg)
How do new words enter the
dictionary?
https://www.youtube.com/watch?v=juwDkP3ovIY
![Page 35: Writing Forensic Reports · 2016. 11. 29. · A workshop developed for ICFP by Karen Gray Writing Forensic Reports . Put it before them briefly so they will read it, clearly so they](https://reader036.fdocuments.us/reader036/viewer/2022071216/6048c8787a82643de35b9470/html5/thumbnails/35.jpg)
CHOOSE THE RIGHT VERBS
Active and passive
voice
Parallelism
Subject-verb
agreement
![Page 36: Writing Forensic Reports · 2016. 11. 29. · A workshop developed for ICFP by Karen Gray Writing Forensic Reports . Put it before them briefly so they will read it, clearly so they](https://reader036.fdocuments.us/reader036/viewer/2022071216/6048c8787a82643de35b9470/html5/thumbnails/36.jpg)
Prefer the active voice
ACTIVE VOICE
The Leadership
Blog brings you
insight, opinion
and debate from
our senior
partners.
PASSIVE VOICE
You are brought
insight, opinion
and debate from
our senior
partners by The
Leadership Blog.
![Page 37: Writing Forensic Reports · 2016. 11. 29. · A workshop developed for ICFP by Karen Gray Writing Forensic Reports . Put it before them briefly so they will read it, clearly so they](https://reader036.fdocuments.us/reader036/viewer/2022071216/6048c8787a82643de35b9470/html5/thumbnails/37.jpg)
“
”
Active verbs make writing direct, clear and concise.
Passive verbs can add variety to writing. They can soften commands, emphasise results, help doers escape accountability, and slow the pace of your writing.
(Adapted from Booher & Hill, 1989: 116)
![Page 38: Writing Forensic Reports · 2016. 11. 29. · A workshop developed for ICFP by Karen Gray Writing Forensic Reports . Put it before them briefly so they will read it, clearly so they](https://reader036.fdocuments.us/reader036/viewer/2022071216/6048c8787a82643de35b9470/html5/thumbnails/38.jpg)
BUT - passive voice can
damage meaning
Passive Voice
It was suggested that
the schedules be
revised by the project
manager.
It is believed that the
city should increase
its reserve water
supply.
Active Voice
The project manager
should revise the
schedules.
Management
suggested that the
project manager
should revise the
schedules.
The city should
increase its reserve
water supply.
![Page 39: Writing Forensic Reports · 2016. 11. 29. · A workshop developed for ICFP by Karen Gray Writing Forensic Reports . Put it before them briefly so they will read it, clearly so they](https://reader036.fdocuments.us/reader036/viewer/2022071216/6048c8787a82643de35b9470/html5/thumbnails/39.jpg)
Over to you
The following
compliance
requirements will be
included in the onsite
assessments.
The onsite
assessments will
include the six
compliance
requirements.
![Page 40: Writing Forensic Reports · 2016. 11. 29. · A workshop developed for ICFP by Karen Gray Writing Forensic Reports . Put it before them briefly so they will read it, clearly so they](https://reader036.fdocuments.us/reader036/viewer/2022071216/6048c8787a82643de35b9470/html5/thumbnails/40.jpg)
![Page 41: Writing Forensic Reports · 2016. 11. 29. · A workshop developed for ICFP by Karen Gray Writing Forensic Reports . Put it before them briefly so they will read it, clearly so they](https://reader036.fdocuments.us/reader036/viewer/2022071216/6048c8787a82643de35b9470/html5/thumbnails/41.jpg)
Use parallelism
Use parallelism to ‘match’ words, phrases
or sentences that are similar in structure
Use the Rule of 3 for emphasis
Simpler
Better
Faster
He came; he saw;
he conquered.
![Page 42: Writing Forensic Reports · 2016. 11. 29. · A workshop developed for ICFP by Karen Gray Writing Forensic Reports . Put it before them briefly so they will read it, clearly so they](https://reader036.fdocuments.us/reader036/viewer/2022071216/6048c8787a82643de35b9470/html5/thumbnails/42.jpg)
Over to you
Please observe the following regulations:
Equipment must be reserved two
weeks ahead
Removing equipment without signing
out is not approved
Equipment must be returned within 48
hours of use
![Page 43: Writing Forensic Reports · 2016. 11. 29. · A workshop developed for ICFP by Karen Gray Writing Forensic Reports . Put it before them briefly so they will read it, clearly so they](https://reader036.fdocuments.us/reader036/viewer/2022071216/6048c8787a82643de35b9470/html5/thumbnails/43.jpg)
Parallel sentence
Please observe the following
regulations:
Reserve equipment two weeks
ahead
Sign out equipment before
removing it
Return equipment within 48 hours
of use
![Page 44: Writing Forensic Reports · 2016. 11. 29. · A workshop developed for ICFP by Karen Gray Writing Forensic Reports . Put it before them briefly so they will read it, clearly so they](https://reader036.fdocuments.us/reader036/viewer/2022071216/6048c8787a82643de35b9470/html5/thumbnails/44.jpg)
Match subjects and verbs
![Page 45: Writing Forensic Reports · 2016. 11. 29. · A workshop developed for ICFP by Karen Gray Writing Forensic Reports . Put it before them briefly so they will read it, clearly so they](https://reader036.fdocuments.us/reader036/viewer/2022071216/6048c8787a82643de35b9470/html5/thumbnails/45.jpg)
Over to you
Choose the correct verb from the
pairs in brackets on page 26?
Good luck!
![Page 46: Writing Forensic Reports · 2016. 11. 29. · A workshop developed for ICFP by Karen Gray Writing Forensic Reports . Put it before them briefly so they will read it, clearly so they](https://reader036.fdocuments.us/reader036/viewer/2022071216/6048c8787a82643de35b9470/html5/thumbnails/46.jpg)
PLAN YOUR DOCUMENT
Brain dump the
content of the
document
Organise
material
logically
![Page 47: Writing Forensic Reports · 2016. 11. 29. · A workshop developed for ICFP by Karen Gray Writing Forensic Reports . Put it before them briefly so they will read it, clearly so they](https://reader036.fdocuments.us/reader036/viewer/2022071216/6048c8787a82643de35b9470/html5/thumbnails/47.jpg)
Purpose of a document
Transmit information
Motivate
![Page 48: Writing Forensic Reports · 2016. 11. 29. · A workshop developed for ICFP by Karen Gray Writing Forensic Reports . Put it before them briefly so they will read it, clearly so they](https://reader036.fdocuments.us/reader036/viewer/2022071216/6048c8787a82643de35b9470/html5/thumbnails/48.jpg)
The purpose of your
document
Transmitting information
Giving information?
Giving bad news?
Motivating
Requesting information?
Requesting a favour?
Persuading?
Advising? ??
![Page 49: Writing Forensic Reports · 2016. 11. 29. · A workshop developed for ICFP by Karen Gray Writing Forensic Reports . Put it before them briefly so they will read it, clearly so they](https://reader036.fdocuments.us/reader036/viewer/2022071216/6048c8787a82643de35b9470/html5/thumbnails/49.jpg)
CHECK THE READABILITY
SCORE
![Page 50: Writing Forensic Reports · 2016. 11. 29. · A workshop developed for ICFP by Karen Gray Writing Forensic Reports . Put it before them briefly so they will read it, clearly so they](https://reader036.fdocuments.us/reader036/viewer/2022071216/6048c8787a82643de35b9470/html5/thumbnails/50.jpg)
The Fog Index
Pick a 100 word sample
Calculate the average sentence length (A)
Count the number of words with 3 or more syllables (B) excluding:
Capitalised
Numbers in numerals
Abbreviations
A + B = C
C x 0.4 = Fog Index
![Page 51: Writing Forensic Reports · 2016. 11. 29. · A workshop developed for ICFP by Karen Gray Writing Forensic Reports . Put it before them briefly so they will read it, clearly so they](https://reader036.fdocuments.us/reader036/viewer/2022071216/6048c8787a82643de35b9470/html5/thumbnails/51.jpg)
Some Readability Guidelines
Email 10
Blogs 11
Business 12
Technical 14
![Page 52: Writing Forensic Reports · 2016. 11. 29. · A workshop developed for ICFP by Karen Gray Writing Forensic Reports . Put it before them briefly so they will read it, clearly so they](https://reader036.fdocuments.us/reader036/viewer/2022071216/6048c8787a82643de35b9470/html5/thumbnails/52.jpg)
Conclusion
What is the best tip you are taking
away from this session?
Punctuation
Vocabulary
Verbs
Planning
Reviewing
![Page 53: Writing Forensic Reports · 2016. 11. 29. · A workshop developed for ICFP by Karen Gray Writing Forensic Reports . Put it before them briefly so they will read it, clearly so they](https://reader036.fdocuments.us/reader036/viewer/2022071216/6048c8787a82643de35b9470/html5/thumbnails/53.jpg)
??