Professional Documents
Culture Documents
Technical Communication A Design Centric Approach 1St Edition Jon Balzotti Online Ebook Texxtbook Full Chapter PDF
Technical Communication A Design Centric Approach 1St Edition Jon Balzotti Online Ebook Texxtbook Full Chapter PDF
https://ebookmeta.com/product/technical-communication-13th-
edition-mike-markel-stuart-a-selber/
https://ebookmeta.com/product/the-profession-and-practice-of-
technical-communication-attw-series-in-technical-and-
professional-communication-1st-edition-cleary/
https://ebookmeta.com/product/security-analytics-a-data-centric-
approach-to-information-security-1st-edition-mehak-khurana/
https://ebookmeta.com/product/technical-communication-canadian-
edition-john-m-lannon/
The Essentials of Technical Communication 5th Edition
Elizabeth Tebeaux
https://ebookmeta.com/product/the-essentials-of-technical-
communication-5th-edition-elizabeth-tebeaux/
https://ebookmeta.com/product/wearable-antennas-and-body-centric-
communication-present-and-future-1st-edition-koul-shiban-kishen-
bharadwaj-richa/
https://ebookmeta.com/product/wearable-antennas-and-body-centric-
communication-present-and-future-1st-edition-koul-shiban-kishen-
bharadwaj-richa-2/
https://ebookmeta.com/product/people-centric-skills-
interpersonal-and-communication-skills-for-financial-
professionals-2nd-edition-danny-m-goldberg/
https://ebookmeta.com/product/continuous-change-and-
communication-in-knowledge-management-1st-edition-jon-arild-
johannessen/
ISTUDY
Technical Communication
Technical Communication: A Design-Centric Approach is a compre-
hensive textbook for introductory courses in technical communica-
tion and professional writing.
Jon Balzotti
First published 2022
by Routledge
605 Tird Avenue, New York, NY 10158
and by Routledge
2 Park Square, Milton Park, Abingdon, Oxon, OX14 4RN
Routledge is an imprint of the Taylor & Francis Group, an informa business
© 2022 Taylor & Francis
Te right of Jon Balzotti to be identifed as author of this work has been asserted in
accordance with sections 77 and 78 of the Copyright, Designs and Patents Act 1988.
All rights reserved. No part of this book may be reprinted or reproduced or utilised in any
form or by any electronic, mechanical, or other means, now known or hereafer invented,
including photocopying and recording, or in any information storage or retrieval system,
without permission in writing from the publishers.
Trademark notice: Product or corporate names may be trademarks or registered trademarks,
and are used only for identifcation and explanation without intent to infringe.
Library of Congress Cataloging-in-Publication Data
Names: Balzotti, Jon, author.
Title: Technical communication : a design-centric approach / Jon Balzotti.
Description: Second edition. | New York, NY : Routledge, 2021. | Includes bibliographical
references and index.
Identifers: LCCN 2021014633 (print) | LCCN 2021014634 (ebook) |
ISBN 9780367438302 (hbk) | ISBN 9780367438234 (pbk) | ISBN 9781003006060 (ebk)
Subjects: LCSH: Communication of technical information.
Classifcation: LCC T10.5 .B344 2021 (print) | LCC T10.5 (ebook) | DDC 601/.4—dc23
LC record available at https://lccn.loc.gov/2021014633
LC ebook record available at https://lccn.loc.gov/2021014634
ISBN: 978-0-367-43830-2 (hbk)
ISBN: 978-0-367-43823-4 (pbk)
ISBN: 978-1-003-00606-0 (ebk)
DOI: 10.4324/9781003006060
Typeset in Minion Pro and Acumin Pro
by Chelsea Ames
Access the companion website: https://microcore.byu.edu/
Publisher’s note
Tis book has been prepared from camera-ready copy provided by the author.
Contents
Part I: Establishing a Framework
Chapter 3: Style
What Is Style? � � � � � � � � � � � � � � � � � � � � � � � � � � �36
Plain Style� � � � � � � � � � � � � � � � � � � � � � � � � � � � � � �38
Persuasive Style � � � � � � � � � � � � � � � � � � � � � � � � � �72
Intercultural Communication � � � � � � � � � � � � � � �80
[v]
ContEnts
Chapter 5: Ethics
Legality � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � �122
Honesty� � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � �124
Confdentiality � � � � � � � � � � � � � � � � � � � � � � � � � �124
Quality � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � �126
Professionalism� � � � � � � � � � � � � � � � � � � � � � � � � �127
Fairness� � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � �128
Objectivity � � � � � � � � � � � � � � � � � � � � � � � � � � � � �130
[ vi ]
ContEnts
Chapter 8: Proposals
What Is a Proposal? � � � � � � � � � � � � � � � � � � � � � � �196
How to Write a Proposal � � � � � � � � � � � � � � � � � � �197
Design-Centric Tinking � � � � � � � � � � � � � � � � � � �212
[ vii ]
ContEnts
[ viii ]
ContEnts
Parentheses � � � � � � � � � � � � � � � � � � � � � � � � � � � � � 374
Brackets � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � 375
Ellipsis� � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � 377
Period � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � 379
Exclamation Point � � � � � � � � � � � � � � � � � � � � � � � 380
Question Mark � � � � � � � � � � � � � � � � � � � � � � � � � � 382
Ampersand � � � � � � � � � � � � � � � � � � � � � � � � � � � � � 383
Slash � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � 385
[ ix ]
ContEnts
Acknowledgments
Associate Designer/Editor
Chelsea Ames
Contributors/Editors:
Lindsey Tanner
Matthew Baker
Lila Rice
Rebecca Cazanave
[x]
Preface
T echnical writing is a contemporary, relevant, and critical skill
for every employee today. Writing is most efective when it is both
well-written and adaptive, namely adaptive to your reader. Tink of
your reader as, above all, your end user. Te highest quality of writ-
ing is that in which you plan, brainstorm, compose, and revise with
your end users' needs in mind. Tose needs will determine your
writing style, your content, your choice of visuals, and your overall
document design, each of which may have important ethical and
legal entailments for you and the company for which you work.
[ xi ]
PrEFACE
Tis book will aid you in developing the skills and attitude neces-
sary to become a professional technical writer and communicator.
Tese are the essentials—let’s master them together.
[ xii ]
Part I:
Establishing
a Framework
It’s important to understand a few establishing principles that will
frame how you approach any writing task. Te purpose of Part I is
to provide you with a context of what technical writing is, intro-
duce a design-centric model that will guide your writing process,
and provide instruction on principles of style, document design,
and ethics.
PArt I
It’s important to note that efective writing isn’t a talent that some
people possess and others don’t. Learning and practicing frame-
works for writing and speaking will enable anyone to write and
communicate efectively. Te job of this textbook is to teach you
those frameworks—the practice is up to you.
[2]
EstAblIshInG A FrAMEwork
https://images.app.goo.gl/JfSmFf5thHTNWtX58
[3]
PArt I
If you have profcient technical writing skills you’ll have more suc-
cess both in starting a career and in succeeding in it than one who
chooses to forego developing such skills.
According to the BLS, job opportunities for those with good tech-
nical writing skills will continue to be plentiful. Taking time now
to hone your writing and overall communication skills is an invest-
ment in your professional success.
As you practice your technical writing skills, you’ll fnd that they
will help you become an invaluable employee in any organization.
[4]
1
CHAPTER
What Is
Technical
Communication?
ChAPtEr 1
The Basics
In very practical terms, technical communication is used every day
by professionals and consumers to solve problems in the workplace.
Te motive of technical communication is to employ words and
images to help readers, not writers, accomplish their goals which
might include helping employees learn something important for
their job, perform a task on the job, or make critical decisions that
impact the long-term security of the company.
[6]
tEChnICAl CoMMunICAtIon
[7]
ChAPtEr 1
[8]
tEChnICAl CoMMunICAtIon
[9]
ChAPtEr 1
Most novice writers focus on the end results of efective writing, but
experienced writers start with asking questions. Te purpose of the
next chapter is to help you fnd the right questions to ask to make
sure you write and design documents that help users. To aid you
in this process, this text uses the design-centric model to improve
your technical writing and communication skills.
[ 10 ]
2
CHAPTER
Design-Centric
Communication
Chapter outline
https://images.app.goo.gl/nLY6uudU69ioVWCQ8
[ 12 ]
DEsIGn-CEntrIC CoMMunICAtIon
Tese fve steps are not linear; you can move forward or backward
through them in any order during your writing process. In the de-
[ 13 ]
ChAPtEr 2
sign world, these steps connect you to your user’s needs, determine
your direction, help you execute your intention, and review your
work. Tey also facilitate thinking outside of any “box” and coming
up with new ideas and ingenious work-arounds.
Empathize
Te frst step in design-centric thinking is empathy. In our mod-
ern digital world of faceless communication, it can be difcult to
imagine fesh and blood humans at the other end. When you send
an email it goes…where? Cultivating an awareness of the person at
the other end—engaging with our capacity to empathize—is how
professional writers “psych out” the reader.
[ 14 ]
DEsIGn-CEntrIC CoMMunICAtIon
https://images.app.goo.gl/NZqoZvNWyDPUPbu66
Understanding end user needs will be the frst important step in
your writing process to craf efective technical documents. In writ-
ing, we call this an ability to empathize with your reader. But how is
it done?
Everyone has the ability to utilize empathy, but like anything else in
this book it must be cultivated through deliberate practice.
Te frst step is to start asking questions about users. You must culti-
vate curiosity and imagination to do it. Writers and communicators
with empathy have learned the art of listening hard, doing all they can
to understand the emotional and workplace needs of their reader.
[ 15 ]
ChAPtEr 2
https://images.app.goo.gl/i7zRdLTYoQHuqanf7
[ 16 ]
DEsIGn-CEntrIC CoMMunICAtIon
In the rest of this chapter you will learn how and when to apply
empathy to your writing, especially as a design-centered thinker, to
predict desires and produce superior professional communication.
[ 17 ]
ChAPtEr 2
https://images.app.goo.gl/Ancmh3xyH2WKbZ5q9
activists, auditors, or competitors of your primary readers. Tey
ofen are motivated to protect themselves or others from inaccurate
information, incomplete logic, or unethical practices that could
occur in documents they examine.
[ 18 ]
DEsIGn-CEntrIC CoMMunICAtIon
Being curious about rather than afraid of who your readers will be
is perhaps the best way to develop empathy and understanding.
You begin by asking important questions: what do potential readers
care about? What do they expect from this document? Why do they
need this document? What problem(s) does this document need to
solve for them? Where and when might they use this document?
[ 19 ]
ChAPtEr 2
https://images.app.goo.gl/pw7YBwsZYJvzmaARA
[ 20 ]
DEsIGn-CEntrIC CoMMunICAtIon
You might determine such things as: what professional role is your
reader in? What is their background? What is their world view?
Level of education?
You can move on from their descriptors, to the ways in which they
may be approaching your writing: what are they looking for and/or
anticipating?
Consider it from their angle: how will they view your topic and
approach you as author? Why will they be picking it up or pulling it
up on their computer and what could they expect to fnd there?
[ 21 ]
ChAPtEr 2
You engage empathy when you fne-tune to your users and think
through these types of points in your pre-writing patterns.
Unfortunately, unlike in design thinking, professional writers rarely
have a pool of end users that they can interview, although it’s rec-
ommended that a professional writer glean as much information as
possible from external stakeholders. Te best alternative is to build
an outline around user needs.
You can utilize empathy by simply learning more about those you
hope to create a product for. If you know all there is to know about
who you’re writing for, you are going to care more about the end
product.
We must have meaning behind what we are doing to care about it.
In what ways will our eforts inform or afect them for the better?
If we know this, we will naturally fnd ourselves putting in more
efort.
[ 22 ]
DEsIGn-CEntrIC CoMMunICAtIon
https://images.app.goo.gl/7fmjNkLeCwkbRbt5
Define
Defne is the next step in the design-centric process. Tis is when
you gather the information you have found and proceed with it. It
is when you determine what the “so what?” will be of the research
you gather.
In the design world, this step focuses on the problem you’re trying
to solve. Te key is to defne it as a specifc challenge that needs a
solution. You want it to be something along the lines of a statement
that clearly lays out the intended situation to be fxed. Lay out the
problem in the simplest terms to efectively narrow in on the aim of
the fnal product.
[ 23 ]
ChAPtEr 2
Your problem statement should not be too narrow, since doing this
limits potential approaches and ideas. If you fear being too broad
or too narrow, err on the side of being too broad when defning the
document’s purpose. You can increase in specifcity as you move
forward with your writing, but it is more difcult to try and expand
your ideas afer establishing prior parameters.
Hopefully you are taking from your prior step, incorporating what
you have learned from looking at your end user. Utilizing that to
[ 24 ]
DEsIGn-CEntrIC CoMMunICAtIon
inform your end goal is the entire point of the frst empathizing
step. If you keep your purpose focused on the user, your project will
remain user-oriented throughout.
[ 25 ]
ChAPtEr 2
Ideate
Te next step in this design-centric model has to do with explo-
ration and looking for many possible solutions to meet your end
user’s particular needs. Don’t be afraid to consider radically difer-
ent solutions for your writing problem, even if they seem to con-
fict with each other. Ernest Hemingway once said that he chose to
“write drunk” but “edit sober,” the sentiment being that one should
try and create unhindered but revise with care.
Along those same lines, you should test the boundaries of your
writing: imagine ideas without assuming they need to obey certain
rules. Let yourself be free to imagine or conceive of something new.
Te concept design thinkers seem to live by is no idea is too stupid
to be tested and follows the principle that even simple ideas can
develop into powerful solutions to problems when allowed to grow.
[ 26 ]
DEsIGn-CEntrIC CoMMunICAtIon
https://images.app.goo.gl/t7QYDpQkofGUASLu9
any strategy and throw out ideas that don’t work for their readers,
even if they’ve invested signifcant time and energy into a single
strategy.
Use some kind of tool to organize and channel what you are com-
ing up with. Tere are many methods with which you might inspire
and urge creativity and idea generation. A wall, a dry erase board, a
spreadsheet, a quick-write exercise, etc. Te possibilities are endless
in order to rouse your brain.
Some methods will work better for you or your team than others.
You will need to have some sort of format or method, however, in
order for your ideation process to go smoothly.
[ 27 ]
ChAPtEr 2
parties involved are not afraid to speak up and share the thoughts
they are having. If the people in attendance are not familiar with
one another, you might even do some work beforehand in the form
of activities or other technique, in order to get people more com-
fortable with one another.
Te point behind this is to create a space where the next big idea
can be found. Tis won’t happen if people don’t feel as if they can
share diferent, big, or out-there ideas. Te more brains the better
on this, so recruit people if you need more thoughts fowing to your
project.
Now to take what has been thought of and whittle it down to the
best choice(s). Tis can also be done in numerous ways; pick the
most efective for you.
Prototype
We now come to the fourth step, where we make our frst versions
and fesh out an actual shadow of what we want to create. Te goal
of this stage is to work out as many kinks as possible before a prod-
uct is released or produced. If we can fnd the issues now, we’ll be
in much better shape than if we were to make critical mistakes in a
real-life version.
[ 28 ]
DEsIGn-CEntrIC CoMMunICAtIon
Know what you are hoping to fnd out in these “beta tests.”
Te key to this step, frankly, is for the writer to fail. For design
thinkers, that means they construct their best ideas out of cheap
materials: plywood, popsicle sticks, Elmer’s Glue, and so on. For
writers, we call this process creating, or materializing, a rough draf.
[ 29 ]
ChAPtEr 2
Never assume that your frst draf will be your fnal draf. Mizrahi
explains: “A frst draf is one of several stabs you’ll take at this work.
. . . Your goal at this stage of the writing process for both short
and longer documents is to put something down on paper (or the
screen) that you will revise later. It’s a waste of your valuable time to
labor over any individual word or sentence as you write your draf;
the word or sentence may be eliminated by the fnal version.”
Starting on a frst draf can be hard: initiating frst steps and start-
ing up your writing process. But in some ways this is the most im-
portant stage, because you can’t create a second, improved version
without putting the frst one down.
[ 30 ]
DEsIGn-CEntrIC CoMMunICAtIon
Test
Testing is connecting our prototype step with our initial project aim
and comparing notes. Did our prototype meet our needs and our
design aim? What might need to be changed or added?
[ 31 ]
ChAPtEr 2
In an app test situation, you are getting people to try the app and
point out any faws, their opinion, and ask questions of them in
order to learn what kind of experience they are having with it. You
want to get any negative feedback now so that changes are in your
hands before you send it out.
As a writer, do the same thing. Let test users have the “product” you
have created, learning where you can improve and what they would
suggest you tweak. If anything is not clear about their feedback,
make sure to ask questions to ensure you know everything you
need to about their experience as users.
By bringing your best ideas to life and testing them with potential
end users, you’ll learn quickly how to improve. Ofen, users may
think they know what they want until they’re confronted with it. In
the design world, when given a prototype that meets their specifca-
tions, users ofen discover new problems or issues with their initial
concerns. Do you see how this might apply to writing?
[ 32 ]
Another random document with
no related content on Scribd:
The Project Gutenberg eBook of Le Harem
entr'ouvert
This ebook is for the use of anyone anywhere in the United
States and most other parts of the world at no cost and with
almost no restrictions whatsoever. You may copy it, give it away
or re-use it under the terms of the Project Gutenberg License
included with this ebook or online at www.gutenberg.org. If you
are not located in the United States, you will have to check the
laws of the country where you are located before using this
eBook.
Author: A. R. de Lens
Language: French
LE
HAREM ENTR’OUVERT
PARIS
CALMANN-LÉVY, ÉDITEURS
3, RUE AUBER, 3
MŒURS TUNISIENNES
I
LA MAISON DU CAÏD MANSOUR
Le caïd Mansour prend le café avec mon mari. Ils sont accroupis
tous deux sur le divan, à la mode arabe, et fument en devisant.
Le caïd Mansour est un personnage digne et conscient de sa
haute importance. Il est toujours vêtu avec la plus grande recherche.
Ses burnous sont en fine laine de Mâteur et ses gebbas aux teintes
pâmées : fleur de pêcher, gris tourterelle, mauve de crépuscule,
éparpillent autour de lui mille tendres reflets de soie.
Quand il entre, la pièce se parfume d’essences subtiles : ambre,
jasmin ou rose.
Le caïd Mansour a des manières exquises et fières. Il me
témoigne une déférence infinie, sachant qu’il convient de traiter les
Européennes avec plus d’égards et de respect que leurs époux.
— Le salut, Si Mansour !
— Le salut sur toi. Comment vas-tu ?
— Comment va ta maison [1] ?
[1] On ne parle jamais ouvertement à un Arabe des
femmes de sa famille.