Documente Academic
Documente Profesional
Documente Cultură
tone.
Stylistics
Prepared by: J. Manalastas (Instructor) A reader expects you to be an expert on the
NEUST-Gapan Academic Extension Campus subject or product discussed in your
document. Write in a style that affirms your
Introduction to stylistics is a language and expertise. For example, too many sentences
style course that will help the students in that include "you can" or "it is
exploring (primarily literary) texts. This recommended" may confuse a reader who
focuses on the relationship between style asks "but should I do this?" Instead, use
and stylistics using stylistic devices and imperative verbs that tell a reader accurately
explain how the language creates meanings and concisely what to do. If you explain that
and effects.
a choice exists, describe for a reader the
advantages and disadvantages of the
alternatives, and make recommendations
1. Understanding Style depending upon different scenarios.
There is extensive literature on good writing One of the great temptations for writers of
style, and this chapter is not intended to computer documentation is the urge to inject
duplicate that literature. However, there are a note of levity into the text to relieve a
a few stylistic issues to discuss that relate reader's (or author's) uneasiness with the
directly to computer documentation. material. This temptation should be resisted -
even genuinely humorous commentary is a
In general, two principles underlie these distraction and will become annoying on
stylistic considerations: subsequent readings. Many attempts at
humor are likely to fail outright. Likewise,
Time is a valuable commodity - humor that descends into "user-friendly
Readers of computer documentation chumminess" never works. A sympathetic
are generally in a hurry. They have
reader may forgive you for trying to "lighten
turned to the documentation to find
up" the text, while another reader may
answers to problems and are
justifiably impatient to get on with the resent a cloying tone.
task at hand. Anything that impedes
the customers' speedy understanding For example, you might think that all readers
is bad style. will enjoy this humor injected into a tutorial:
Readers are worldwide - Foreign
markets are a significant source of You can use a mouse (one without fur)
revenue for manufacturers of with the window environment on your
computer products, and more computer.
frequently than ever before,
documentation is being translated into However, "one without fur" detracts from the
languages other than English. content of the sentence and distracts a
reader.
Write Simply, Directly, and Accurately
Most importantly, humor is difficult (if not
Straightforward, uncluttered writing is easier impossible) to translate successfully. Humor
to understand and translate than more is strictly cultural; what may be funny to
convoluted text. Keep sentences and syntax Americans could be obscene to readers in
simple. Use short, familiar words. Respect a another country.
reader's level of technical knowledge and
competency and make sure that your writing
Avoid Jargon understanding occurs on an almost
subliminal basis, and so that truly significant
Writers frequently incorporate jargon points stand out more clearly. This is one of
associated with the subject matter into their the most valuable aspects of good style.
documentation, in part to demonstrate their
mastery of the subject, and in part because
jargon adds "color" to documentation. This is
another temptation that you should resist. Anticipate a Reader's Questions
Jargon can be difficult for "non-initiates" to One of the most important contributions a
understand and will impede comprehension. writer makes is to anticipate a reader's
Jargon also can be ambiguous; different questions and provide appropriate answers.
fields of expertise can interpret the same As the subject expert, a writer can create a
jargon in different ways. Finally, jargon can climate of understanding that is far more
be very difficult to translate. significant than merely recounting facts
about the product.
Awkward: Tell each user to shut down For example, if you want to tell a user
his machine. how to copy a file from someone else's
directory, try this:
Better: Tell the users to shut down
their machines. Before you can copy a file from
someone else's directory - Sally
Eliminate the possessive as much as Smith's, for example - you need
possible when you're writing in the permission. Ask Smith to set her
third person. file permissions to grant you
access. After she has changed
Awkward: Ask your system permissions,
administrator for his advice. you are free to copy the file.
Better: Ask your system administrator Create your own techniques, keeping
for advice. in mind that writing has to sound
natural, has to be taken literally, and
Use the word "you." has to inform. Don't settle for
inoffensiveness if you can also be
Awkward: If the user decides he wants enlightening.
to change the settings . . . .
Example #1
Types of Style
An excerpt from The Pleasures of
There are four basic literary styles used in Imagination by Joseph Addison
writing. These styles distinguish the work of
different authors from one another. Here are The pleasures of the imagination, taken in
four styles of writing: their full extent, are not so gross as those of
sense A man of polite imagination is let
into a great many pleasures A man should
endeavor, therefore, to make the sphere of
Expository or Argumentative style his innocent pleasures as wide as possible,
that he may retire into them with safety
Expository writing style is a subject-oriented Delightful scenes, whether in nature,
style. The focus of the writer in this type of painting, or poetry, have a kindly influence
writing style is to tell the readers about a on the body, as well as the mind, and not
specific subject or topic and in the end the only serve to clear and brighten the
author leaves out his own opinion about that imagination, but are able to disperse grief
topic. and melancholy
This is an example of expository writing style In this poem, Coleridge uses narrative style
in which the author describes advantages of and tells a story about the ancient mariner.
imagination with facts and logical sequence He uses dialogues, disputes, actions and
and tells his delight of imagination. Then, he events in a sequence, thus provides a perfect
discusses its benefits and finally gives example of the narrative style of writing.
opinions in its favor.
Example #4
Example #2
An excerpt from Dorian Gray by Oscar Wilde
Here is an excerpt from a poem.
The studio was filled with the rich odor of
A drop fell on the apple tree, roses, and when the light summer wind
Another on the roof, stirred amidst the trees of the garden The
And made the gables laugh, sullen murmur of the bees shouldering their
The breezes brought dejected lutes, way through or circling with monotonous
And bathed them in the glee; insistence
And signed the fete away.
(Summer Shower by Emily Dickinson) This is a good example of descriptive writing
style since the author gives visualizations,
This poem is giving an example of feelings, description of a location and details
descriptive style. Emily gives a description of about bees that could be seen and heard.
a summer rainstorm in detail and visualizes
with images so that the readers could
visualize this storm in their own minds as if it
is actually happening. Function of Style