josef verbanac - voice is (a) best practice
TRANSCRIPT
Voice is (a) Best Practice
Josef [email protected]
Writing is easy!
(Perhaps not…)
Voice “The combination of a common usage of syntax, diction, punctuation, character development, dialogue, etc., within a given body of text.”
Basically: “How to make your writing meaningful to the reader.”
Something is definitely missing…
What about Audience?
What about Content?
What about Design?
A better model: Who are your readers? What should they know? How will you tell them?
First, the Who:
How do you figure out who your readers/users are?
Second, the What:
How do you know what they need?
Third, the How:
How do you address them appropriately?
And when this happens?
You can’t just say:
Iterate!
And those best practices?
Your Peers:
The Experts:
Industry Standards:
Current Style Guides:
Eventually:
[email protected] Your Own.
To recap: Know your audience. Manage the content. Design systemically.
Writing complements code.
References
Carey, Michelle, et al. Developing Quality Technical Information, 3rd ed. Indianapolis: IBM Press, 2014.(http://www.amazon.com/Developing-Quality-Technical-Information-Handbook/dp/0133118975/)
DeRespinis, Francis, et al. The IBM Style Guide, 1st ed. Indianapolis: IBM Press, 2011.(http://www.amazon.com/IBM-Style-Guide-Conventions-Writers/dp/0132101300/)
Google. Material Design. Google.com, 2016.(https://www.google.com/design/spec/style/writing.html)
The Economist. Style Guide. Economist.com, 2016.(http://www.economist.com/styleguide/introduction)
Microsoft. Microsoft Manual of Style, 4th ed. Seattle: Microsoft Press, 2012.(http://www.amazon.com/Microsoft-Manual-Style-4th-Corporation/dp/0735648719/)
Pinker, Steven. The Sense of Style, 4th ed. New York: Penguin Books, 2015.(http://www.amazon.com/Sense-Style-Thinking-Persons-Writing/dp/0143127799/)
Strunk, William and E.B. White. The Elements of Style. New York: Pearson, 1999.(http://www.amazon.com/Elements-Style-Fourth-William-Strunk/dp/020530902X/)
University of Chicago Press. The Chicago Manual of Style, 16th ed. Chicago: UCP, 2010.(http://www.amazon.com/Chicago-Manual-Style-16th/dp/0226104206/)
Zinsser, William. On Writing Well, 30th Anv ed. New York: Harper, 2016.(http://www.amazon.com/Writing-Well-Classic-Guide-Nonfiction/dp/0060891548/)
Image Sources
[How to draw an owl]https://www.reddit.com/r/pics/comments/d3zhx/how_to_draw_an_owl/?
[Wikipedia: Writer's voice]https://en.wikipedia.org/wiki/Writer%27s_voice
[Faceless crowd]http://waitbutwhy.com/2015/03/7-3-billion-people-one-building.html
[Ranger lunar probes slip chart – NASA]NASA. (1977). “Lunar impact: A history of project ranger.”(http://ntrs.nasa.gov/archive/nasa/casi.ntrs.nasa.gov/19780007206_1978007206.pdf)
[Visco, Frank L. “How To Write Good.” Writer’s Digest: June, 1968.]https://betterwritingnow.com/2013/11/26/some-comic-relief-how-to-write-good/
[Brentingby Derailment]https://www.flickr.com/photos/frosted_peppercorn/205501453/
[RTFM coffee mug]https://www.flickr.com/photos/99247795@N00/2263136517
[ICRAVE open office]http://www.icrave.com/project/icrave-studio/
[Google Material Design: Writing]https://material.google.com/style/writing.html
[Hello, my name is]http://2.bp.blogspot.com/-DS4mHVsJThA/VD8xpclcs1I/AAAAAAAA2m0/xBTTYJnrEF4/s1600/mynameis.png
[Perfect English Grammar logo]http://www.perfect-english-grammar.com/
[StackOverflow logo]http://stackoverflow.com/