Free Essay

Technical Writing

In:

Submitted By kikaykay
Words 1375
Pages 6
STYLES IN TECHNICAL WRITING

What is style in technical writing?
Styles: the feature of one’s writing that show its individuality, separating it from the writing of another. Style result from the conscious and subconscious decisions each writer makes in matters like word choice, word order, sentence length, and active and passive voice. These decisions are different from the “right and wrong” matters of wrong grammar and mechanics. Instead, they comprise writers make in deciding how to transmit ideas to others.
Different styles in technical writing:
a.a. Writing in clear sentences:
Guideline 1: Place the Main Point near the Beginning
One way to satisfy this criterion for good style is to avoid excessive use of the passive voice. Another way is to avoid lengthy introduction phrases or clauses at the beginning of sentences.
Guideline 2: Focus on One Main Clause in Each Sentences
When you sting together too many clauses with “and” or “but,” you dilute the meaning of your text. However, an occasional compound or compound-complex sentences is acceptable, just for variety.
Guideline 3: Vary Sentences Length but Seek an Average Length of 15-20 Words
Of course, do not think your writing process by counting words while you write. Instead, analyze one of your previous reports to see how you fare. If your sentences are too long, make an effort to shorten them, such as by making two sentences out of one compound sentences connected by “and” or a “but.”
a.b. Being Concise:
Guideline 1: Replace Abstract Nouns with Verbs Concise writing depends more on verbs that it does on nouns. Sentences that contain abstract nouns, specially ones with more than two syllables, can be shortened by focusing on strong verbs instead. By converting abstract nouns to action verbs, you can eliminate wordiness, as the following sentences illustrate
:
Wordy:” The acquisition of the property was accomplished trough long and hard negotiations.”

Concise:”The property was acquired through long and hard negotiations.”
As the examples show, abstract nouns often end with ”-tion” or “-ment” and are often followed by the preposition “of.” These words are not always “bad” words; they cause problems only then cause problems on when they replace action verbs from which they are derived. The following examples show some noun phrases along with the preferred verb substitutes: assessment of asses classification of classify computation of compute delegation of delegate development of develop disbursement of disburse documentation of document elimination of eliminate

Guideline 2: Shorten Wordy Phrases
Many wordy phrases have become common in business and technical writing. Weighty expression add unnecessary words and rob prose of clarity. Here are some of the culprits, along with their concise substitutes: afford an opportunity to permit along the lines of like an additional another at later date later at this point in time now by means of by come to end end due to the fact that because during the course of during for the purpose of for

Guideline 3: Replace Long Words with Short Ones In grade school, most students are taught to experiment with long words. Although this effort build vocabularies, it also can lead to a lifelong tendency to use long words when short ones will do. Of course, sometimes you want to use to longer words just for variety--- for example, using an occasional “approximately” for the preferred “about.” As a rule, however, the following long words in the left column routinely should be replaced by the short in the right column:

advantageous helpful alleviate lessen, lighten approximately about cognizant aware commence start, begin demonstrate show discontinue end, stop endeavor carry out finalize end, complete implement carry out

Guideline 4: Leave out Clichés
Clichés are worn-out expressions that add words to your writing. Through they once were refresh phrases, they became clichés when they no longer conveyed their original meaning. You can make writing more concise by replacing clichés with a good adjective. Here are some clichés to avoid: as plain as day ballpark figure efficient and effective few and far between last but not least leaps and bounds
Guideline 5: Make Writing More Direct by Reading It Aloud Much wordiness results from talking around a topic. Sometimes called “circumlocution,” this stylistic flaw arises from a tendency to write indirectly. It can be avoided by reading passages aloud. Hearing the sound of the words makes wordiness quite apparent. It helps condense all kinds of inflated language, including the wordy expressions mentioned earlier. Remember, however, that direct writing must also retain a tactful, diplomatic tone when it conveys negative or sensitive information.

Guideline 6: Avoid “There Are,” “It Is,” and Similar Constructions There Are,” and “It Is,” should not be substituted for concrete subjects and action verbs, which are preferable in good writing. Such constructions delays the delivery of information about who or what s doing something. They tend to make your writing lifeless and abstract. Avoid them by creating (1) main subject that are concrete nouns and (2) main verbs that are action words. Note that the following revised passages give readers a clear idea of who is doinmg what in the subjects and verb positions.

Guideline 7: Cut Out Extra Words This guideline covers all wordiness errors not mentioned earlier. You need to keep a vigilant eye for any extra words or redundant phrasing. Sometimes the problem comes in them form of needless connecting words. Like to be or that. Other times it appears as redundant points --- that is, those that have been made earlier in a sentence, paragraph, or section and do not need repeating.

a.c. Being Accurate in Wording

Guideline 1: Distinguish Facts from Opinion In practice, this guideline means you must identify opinions and judgments as such by using phrases like “we recommend,” “we suggest,” or “in our opinion.”

Guideline 2: Include Obvious Qualifying Statements When Needed This guideline not mean you have to be overly defensive in every part of the report. It does mean that you must be wary possible misinterpretations.

Guideline 3: Use Absolute Words Carefully Avoid words that convey an absolute meaning or a stronger meaning than you intend. One notable example is “minimize,” which means to reduce to the lowest possible level or amount. If a report claims that a piece of equipment will “minimize” breakdown on life. The reader could consider any breakdown at all to be violation of the report’s implications. If the writer had used the verb “limit” or “reduce,” the wording would have been accurate and less open to misunderstanding.

a.d. Using The Active Voice The active voice is the most commonly used in many languages and represents the "normal" case, in which the subject of the verb is the agent.The passive voice is employed in a clause whose subject expresses the theme or patient of the verb. That is, it undergoes an action or has its state changed.

a.e. Using NONSEXIST Language
Technique 1: Avoid Personal Pronouns Altogether One easy way to avoid sexist language is to delete or replace unnecessary pronouns.

Technique 2: Use Plural Pronouns Instead of Singular In most contexts you can from singular to plural pronouns without altering meaning. The plural usage avoids the problems of using masculine pronouns.

Technique 3: Alternate Masculine and Feminine Pronouns Writers who prefer singular pronoun can avoid sexiest use by altering “he and “him” with “she” and “her.” Using this technique usually avoids the unsettling practice of switching pronouns use within too brief a passage, such as a paragraph or page. Instead, writers may switch every few pages, or every section or chapter.

Technique 4: Use Forms Like “He or She,” “Hers or His,” and “Him or Her” This solution requires the writer to include pronouns for both genders.

Technique 5: Shift to Second-Person Pronouns Consider shifting to the use of “you” and “your,” words without any sexual bais. This technique is effective only with documents in which it is appropriate to use an instruction-related “command” tone associated with the use “you.”

Technique 6: Be Especially Careful of Titles and Letter Salutations When you do not know how a woman you are writing prefers to be addressed, use “ms.” Even better, call the person’s employer and ask of the recipient goes by “Miss’” or some other title.

Similar Documents

Premium Essay

Technical Writing

...Technical Writing and Writing a Technical Report [pic]Understand the type of technical report you are writing. Technical reports come in all shapes and sizes, but they all share the same goal of communicating information clearly. Deciding what type of document you need to write is an important first step as it influences your approach. For example, the following demand different approaches. Reporting Research Findings These documents describe the work done to gather information in the laboratory or field. They can be simple recording or data or more thorough and include: the problem or issue examined, the method or equipment used, the data collected and the implications. Simple Technical Information Report This document explains a technical subject. It has no aim other than to make sure readers understand the topic clearly. For example, a technical report on a investing in the futures market would probably explain how the market evolved, how it works, the specialist terms used and so on. A simple technical report for information does not put forward a view on the merits of investing in the market or have recommendations. Technical Specifications Specifications typically consist of descriptions of the features, materials, uses and workings of new product. Good specifications concentrate on graphics, data and illustrations rather than written descriptions. Think of a patent application as a good example. Technical Evaluation Reports Evaluation reports, sometimes called...

Words: 3230 - Pages: 13

Free Essay

Technical Writing

...This article is a guide to careers in technical writing. If you are interested in technical writing, here is a guide to the profession, and it include six parts. First, you need to know if technical writing is for you. Saul Carliner think that write a novel is not the job. Although the finished product is something you wrote, there's a lot of collaboration. Contrary to what many assume, this job requires plenty of contact with technical professionals, from programmers and project managers to machine operators and medical technicians. If you're considering a job as a technical writer, and you always spend several hours reading and reviewing computer manuals and online help systems. You need to know no one in the outside world will ever see it. But the field has broadened to include a variety of job roles and responsibilities. Second, you need background. As a group, technical communicators come from varied backgrounds. The five most common academic backgrounds are English, technical communication, science or engineering, computer science and journalism. Third, you need to know specific programs. You should know Microsoft word, FrameMaker, and RoboHelp. Forth, you can move into other IT jobs. Technical communicators often move into jobs as programmers, systems analysts, information architects and project leaders. Others shift into sales or management roles. Fifth, you need to get experience. Budding technical communicators should seek out internships, volunteer work and other...

Words: 264 - Pages: 2

Free Essay

Technical Writing Report

...Technical The Basics of Technical Writing for Management Information Systems Professionals David J. Donahoo Associate Professor, Liberty University Lynchburg, Virginia Submitted in Accordance With Guidance in the CSIS 100 Syllabus Abstract This paper provides students in the CSIS 100 course with an introduction to technical writing—one of the critical success factors for their future employment and career advancement. In this paper, students will be exposed to Four basic skills that will improve your technical writing. These include: flow and format, writing in complete thoughts, proper use of white space, and readability. This paper provides various tips to help you be successful in your college research writing and your follow-on professional life. Table of Contents Abstract 3 Introduction 6 General Concepts 6 Flow and Format 7 Flow 7 Flow Tips and Pointers 7 TIP 1:  Body 8 TIP 2: Introduction 8 TIP 3: Conclusion 8 Format 9 Complete Thoughts 9 White Space 10 Readability 11 Conclusion 12 Sample References 13 Introduction No matter where you are at in your life-long educational or professional career you will benefit from honing your technical writing skills. Believe me when I say this; technical writing takes your normal writing skills in a different direction. Some of the things you received praise from in high school composition classes will draw scorn in...

Words: 2011 - Pages: 9

Premium Essay

Personal Narrative: My Technical Writing Skills

...Final Exam Essay 1 Over the course of the semester, my technical writing skills have improved significantly. I am now a master of framing the problem, rhetorical awareness, and distinguishing between “good” and “bad” writing. I will be able to take these skills that I have learned over the course of the semester and apply it to my future law career. Throughout this essay, I will analyze three improvements of my writing and provide detail examples to support my analysis. First, my technical writing skills have improved by learning how to appropriately frame a problem in an argument. Framing is a way of presenting a problem or issue in a certain way that it gets on the policy agenda and being an advocate for this problem or issue can help...

Words: 839 - Pages: 4

Premium Essay

Technical Writing

...Technical Writing Project Cover Sheet Capstone Proposal Project Name: Collaborative Business Intelligence Implementation Student Name: Joseph Thomas Degree Program: BSIT Mentor Name: Jeff Davis Signature Block JOSEPH THOMAS Student’s Signature Joseph Thomas Mentor’s Signature Table of Contents Capstone Proposal Summary 1 Review of Other Work 1 Rationale and Systems Analysis 1 Goals and Objectives 2 Project Deliverables 2 Project Plan and Timelines 2 References 3 Appendix 1: Competency Matrix 4 Appendix 2: 5 Appendix 3: 6 Capstone Proposal Summary The ClientABC has outgrown their existing file server environment, and is looking for a content management system with analytical capabilities. They have provided us with detailed requirements, and we have recommended the implementation of a Microsoft® SharePoint portal leveraging Microsoft® SQL Server for a Business Intelligence solution. The portal will only be required to be accessible from within the organization and not externally. This platform will address the specific needs of each department by allowing users to upload and share department documents, such as polices. The IT department will work with other department managers to develop custom workflows based on their business processes needs. The Administration group will help define the analytical dashboard and reporting needs of the organization, with the focus...

Words: 1566 - Pages: 7

Free Essay

Technical Writing

...correct square to relay the message. A technical report (also: scientific report) is a document that describes the process, progress, or results of technical or scientific research or the state of a technical or scientific research problem. It might also include recommendations and conclusions of the research. Unlike other scientific literature, such as scientific journals and the proceedings of some academic conferences, technical reports rarely undergo comprehensive independent peer review before publication. They may be considered as grey literature. Where there is a review process, it is often limited to within the originating organization. Similarly, there are no formal publishing procedures for such reports, except where established locally. Description Technical reports are today a major source of scientific and technical information. They are prepared for internal or wider distribution by many organizations, most of which lack the extensive editing and printing facilities of commercial publishers. Technical reports are often prepared for sponsors of research projects. Another case where a technical report may be produced is when more information is produced for an academic paper than is acceptable or feasible to publish in a peer-reviewed publication; examples of this include in-depth experimental details, additional results, or the architecture of a computer model. Researchers may also publish work in early form as a technical report to establish novelty, without having...

Words: 1284 - Pages: 6

Free Essay

Technical Writing

...Medicare and Medicaid are both government-sponsored programs designed to help cover healthcare costs. While both were established by the U.S. government in 1965 and are taxpayer funded, they are actually very different programs with differing eligibility requirements and coverage. Medicare is designed to help with long-term care for the elderly, while Medicaid covers healthcare costs for the poor. Medicare is a federal program attached to Social Security. It is available to all U.S. citizens 65 years of age or older and it also covers people with certain disabilities. It is available regardless of income. Medicaid is a joint federal and state program that helps low-income individuals and families pay for the costs associated with medical and long-term custodial care. The federal government funds up to 50% of the cost of each state's Medicaid program, with more affluent states receiving less funding than less affluent states. Because of this federal/state partnership, there are actually 50 different Medicaid programs, one for each state. Unlike Medicare, which is available to everyone, Medicaid has strict eligibility requirements. Medicaid is often used to fund long-term care, which is not covered by Medicare or by most private health insurance policies. Medicaid is the nation's largest single source of long-term care funding. Medicare and Medicaid programs work together to provide medical coverage to elderly and poor people. Medicare is the primary medical coverage provider...

Words: 312 - Pages: 2

Free Essay

Technical Writing

...Dear Valued Customer, At CPAs Industries Incorporated, your satisfaction is our primary concern. Combining advanced engineering and marketing concepts with first- rate Filipino craftsmanship, we give you products that pass through rigid quality control tests to ensure their reliability and consistency of performance. The new lightweight touch screen calculator is the latest result of our continuing commitment to provide you with durable and energy- efficient device. Today’s modern world, a high tech way of calculating is necessary to save time and energy. For your convenience, we have established a nationwide network of strategically located maintenance and repair centers to service any CII product. Should you have a problem with your unit please see or call the CII franchise service centers nearest your home. Our service centers will be most happy to assist you. Truly Yours, MA. VELLE M. MARIANO Chairman and Chief Executive Officer PRODUCT DESCRIPTION Digi-E-Calc stands for “Digital Electronic Calculator”. It is a calculator with high-tech features and state-of-the-art design. Digi-E-Calc is a rectangular lightweight tablet which measures 5”x3.5”x0.5” with ultrasensitive touch screen and lithium and dry cell batteries which could last for two days (and can be recharged again just by connecting the power plug located at the side of the gadget in an outlet. Its two dry cell batteries can be used as a back-up power supply in case of a power drain of the lithium...

Words: 2658 - Pages: 11

Free Essay

Technical Writing

...Professional Knowledge and Abilities Calvin Nicholson GEN/200 January 22, 2011 James Tagliamonte Professional Knowledge and Abilities The American Society for Training and Development was founded in 1944 and now boasts a membership of about 70,000 business professionals. As stated in the ASTD website, it is a leading association of workplace learning and performance professionals forming a world-class community of practice. Their website lists a wealth of resources they offer which includes exclusive research tools, publications, career support, discount on books, conferences and professional development workshops as well as endless opportunities to network with colleagues from around the world. It also enumerated the numerous certificate programs that can help provide the necessary knowledge, training and recognition needed by business professionals to perform on their jobs and succeed. One certification that would be very beneficial to obtain is the CPLP which stands for Certified Professional in Learning and Performance. Aside from providing valuable resources and learning materials, this association also provides the opportunity for networking among peers. The ASTD sponsors conferences and expos and online discussion forums. These conferences and expos have themes that are extremely important in today’s global network. Topics range from outsourcing to e-learning and use of technology. By being the voice of the profession, the ASTD also became a tool...

Words: 521 - Pages: 3

Free Essay

Technical Writing

...D-Wave Computer's Solution Raises More Questions Sophie Bushwick An experimental computer made by a Canadian company has proved its ability to solve increasingly complex mathematical problems. But the question remains — just how much of this calculating power is actually due to the strange properties of quantum mechanics? In theory, quantum computers can perform calculations far faster than their classical counterparts to solve incredibly complex problems. They do this by storing information in quantum bits, or qubits. At any given moment, each of a classical computer's bits can only be in an “on” or an “off” state. They exist inside conventional electronic circuits, which follow the 19th-century rules of classical physics. A qubit, on the other hand, can be created with an electron, or inside a superconducting loop. Obeying the counterintuitive logic of quantum mechanics, a qubit can act as if it’s “on” and “off” simultaneously. It can also become tightly linked to the state of its fellow qubits, a situation called entanglement. These are two of the unusual properties that enable quantum computers to test multiple solutions at the same time. But in practice, a physical quantum computer is incredibly difficult to run. Entanglement is delicate, and very easily disrupted by outside influences. Add more qubits to increase the device's calculating power, and it becomes more difficult to maintain entanglement. Instead of struggling to keep ever-larger numbers of qubits...

Words: 1002 - Pages: 5

Free Essay

Technical Writing

...1. In the previous exercise, you found article related to millennials.  For this exercise, please either find the same article or conduct a new search and find a new article on the topic of millennials. When you have found the article, follow the instructions provided on the video and select a new database on the right-hand side of your screen.  Then answer the following questions: -What database did you select? ABI/INFORM Global -How many hits do you find? 3,385,038 When you have found an article, follow the instructions provided on the video and select a new database on the right-hand side of your screen.  Then answer the following questions: -What were your search terms? (Fast food OR restaurants OR eatery) AND (Obesity OR Overweight) AND (Children OR Adolescents) -What database did you select on the right-hand side?  Health Source: Nursing/Academic Edition Why did you select this database? I select this database because it mostly consist of health issues and clinical nutrition. -How many hits do you find after choosing this database?   48,245 Jobs — There’s a minimum wage, but should there also be a maximum wage/salary a person can earn? School — Exams often do little more than measure a person’s ability to take exams. Should exams be outlawed in favor of another form of assessment? Personal — should people with earing-aid be exposed to more noise around them? Topic: There’s a minimum wage, but should there also be a maximum wage/salary...

Words: 343 - Pages: 2

Free Essay

Technical Report Writing

...THE UNIVERSITY OF THE WEST INDIES ST. AUGUSTINE, TRINIDAD AND TOBAGO, WEST INDIES FACULTY OF ENGINEERING & ENGINEERING STUDENTS’ SOCIETY Technical Report Writing Workshop Facilitated by: Halcyon Lawrence March 03, 2007 Table of Contents Topic 1: The Communication Model ............................................................................. 4 Topic 2: Five Cs of Technical Communication .............................................................. 7 Clarity ............................................................................................................................. 7 Structural Clarity (document level) ............................................................................ 7 Stylistic Clarity ........................................................................................................... 7 Grammatical Clarity.................................................................................................... 7 Contextual Clarity....................................................................................................... 7 Conciseness..................................................................................................................... 8 Document level Conciseness ...................................................................................... 8 Paragraph/sentence level Conciseness........................................................................ 8 Concreteness ......................................

Words: 11012 - Pages: 45

Premium Essay

Technical Writing Proposal

...INTERNET MINIATURE PINSCHER SERVICE (IMPS) DC METRO REGION LET'S SAVE MORE MINIATURE PINSCHERS Proposal to Update IMPS Maximum Intake Age William L. Harris Jr, IMPS Regional Coordinator DC, DE, MD, VA, WV 12/13/2014 Informative Abstract: This proposal is the result of research into the effects of the current Internet Miniature pinscher Service policy restricting the intake age limit of five for rescues. The current policy is in effect from a time in the past when money was tight and vet bills were high. The proposal highlights three possible courses of action including maintaining the status quo, changing the limit to seven years and replacing the age limit with a percentage based system to identify how many seniors can be taken in. The author identifies multiple ideas that can be used to bring the veterinary costs down while at the same time allowing more dogs to be rescued. Of the three Courses of Action, only one works today, which is the increase to seven, but there is a way forward highlighted that could eventually result in a removal of the age limit and conversion to a percentage based senior intake system. William L. Harris Regional Coordinator DC, DE, MD, VA, WV Internet Miniature Pinscher Service 1730 Underwood Rd Gambrills, MD 21054 13 December 2014 Petrea Hoving National Director Internet Miniature Pinscher Service 55 East 72nd St Apt 4N New York, NY 10021 Dear Petrea Hoving: Enclosed please find a proposal entitled...

Words: 2721 - Pages: 11

Premium Essay

Technical Writing Manual

... | | | | Table of Content I. Introduction 1 A. Summary 1 B. Purpose 1 C. Glossary of Terms 1 II. Center for Writing Excellence 2 A. Introduction to the Center for Writing Excellence 2 B. WritePoint 2 C. Tutor Review 3 D. Plagiarism Check 3 E. How to submit a document for review 3 F. Writing Tools 4 1. Tutorials and Guides 4 2. Writing Manuals 5 3. Finding Help 5 III. Library Services 6 A. Introduction to Library Services 6 B. Search FAQ’s 7 C. Ask a Librarian 7 D. Request a Specific Document 8 E. View the Research Tutorial 9 F. Read the Library Guide 9 G. Library Resources 9 1. Article Databases – Major 10 2. Article Databases – Specialized 10 3. Books, Dissertations, and Theses 10 4. Canadian Indexes 10 5. Company Directories and Financials 10 6. Country Profiles and Economic Data 10 7. Encyclopedias and Dictionaries 10 8. Journal Indexes and Abstracts 11 9. Test Guides and Preparation 11 10. Writing and Publishing Resources 11 11. Choose Databases by Subject 11 12. Find a Specific Publication 11 13. Biblioteca in Español 11 14. Library Resources Location 11 IV. Center for Mathematics Excellence 13 A. Introduction to Center for Mathematics Excellence 13 B. Running Start 13 C. Math Anxiety 13 V. Element K Tutorial 14 A...

Words: 3529 - Pages: 15

Premium Essay

Technical Writing - Radon

...[pic] Homeowners Radon Alert [pic] All homeowners need to be aware of the very real risks of home radon exposure. This bulletin will tell you what you need to know about radon exposure and how to protect your home. What is radon and what are the dangers of radon exposure in a home? Radon is a colorless, odorless, tasteless gas that is created by the natural breakdown of uranium in the earth. The accumulation of radon in a home can present a very real health hazard. Prolonged inhalation of radon gas leads to an increased risk of developing lung cancer. How does radon get into a home? Radon is present in the soil and air in varying quantities almost everywhere in the world. Radon levels vary from home to home, depending on the structure of the house and the surrounding soil. The most common entry paths for radon are through small spaces, such as cracks in concrete, floor drains, sump pump openings, wall/floor joints in basements, and the pores in hollow brick walls. Radon generally concentrates most in the areas of a home closest to the ground and decreases in upper stories. Radon can also seep into underground water and remain trapped there. Homes where water is supplied through a ground water supply source, such as a well, have a greater potential for radon problems. Homes with water supplied by a municipal water supply have fewer problems with radon. How is radon detected in a home? Testing is the only...

Words: 531 - Pages: 3