...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
...director and an account executive, increasing client complaints about quality of work, productivity and demoralization of employees within that branch. II. Site visit to Roanoke branch was performed in order to investigate issues. A. Preformed one-on-one employee interviews in order understand the reasons behind declining morale within the branch. 1. Conducted interviews with four out of six employees from the Accounts Management department. 2. Interviewed the general manager of Roanoke branch. 3. Had a group meeting with entire Creative Services department. B. Observed work environment to get a feel for how employees interact with one another and understand workflow within the office. C. Reviewed past year of business reports. D. Reviewed policy and procedure manual. 1. Polices for new client accounts were reviewed and updated. 2. Overtime compensation for salaried employees was not addressed in the company’s policy manual. E. Interviewed clients both satisfied and dissatisfied. 1. Conducted phone surveys with dissatisfied clients who had recently closed their accounts with Roanoke branch. 2. Mailed out satisfaction surveys to current client list of Roanoke branch. III. Main causes for problems plaguing the Roanoke branch are the unlimited number of new client projects, short staffing and thus overworked employees, lack of communication between departments, and declining employee job satisfaction. A. One-on-one interviews with employees...
Words: 1093 - Pages: 5
...Technical paper Name Date Object oriented Program or rather OOP entails an object with data files which are organized in a manner that integrates procedures ad instructions that are incorporated into data fields. The system is essential in combining computer programs with a similar objective and point of operations. For example, computer operations have a similar language that is integrated in programming such as JavaScript, Smalltalk, and Python C ++. The difference is similar due to data and codes that are used to give attention to connected programs. The scope area focuses on how the way a company collects and aggregates data from disparate data sources. Additionally, the actual data collection in the organization ensures reliability and validity of actual collected. Innovative information data collection method simplifies data and aids data sharing among every department. Their scope of data management and analysis entails the second concept of data analysis. IT innovations have helped different organizations to access data from different departments. This means that OOP methodology is convenient is saving data and it is more secure when handling data from crucial projects. The object oriented programming therefore enables one to create objects and classes also that are prototypes or better imitate the real world unlike in the technical programming that puts more prominence on orders rather than the presentation. The main objective...
Words: 886 - Pages: 4
...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
...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
...categoryId=-1 IF You Face Any Problem Then E Mail Us At JOHNMATE1122@GMAIL.COM Question week 1 Technical Communication at Work (graded) As you read Chapter 1, you will learn that communication skills are critical in the workplace and that technical writing is used in virtually every work environment. For this discussion, locate a technical document from your workplace or from home or the Internet, preferably one that might be found in your career field. Note that Figure 1-1 (page 4) provides a list of technical communication examples. Using the five goals and features of technical communication listed in the textbook (page 4), describe how the document addresses these characteristics. Then, discuss whether or not you feel the document is successful in its overall goal. Provide examples from the document to illustrate. If possible, share the document by posting a link or a PDF of the sample used. Audience Culture and Analysis (graded) As our text states, “one cardinal rule governs all on-the-job writing: Write for your reader, not for yourself” (page 41). This requires a solid audience analysis. As part of this analysis, you must also consider the audience's cultural background, particularly in light of today's global society. For this discussion 1. discuss some general reader characteristics and methods for analyzing the readers of various technical and workplace documents; and 2. describe additional considerations you need to make when dealing with a...
Words: 3667 - Pages: 15
...Course Syllabus SCBSIT0810 Technical Writing Fundamentals: ENG 221 Course Start Date: 03/08/2011 Course End Date: 04/05/2011 Campus/Learning Center: Schaumburg Please print a copy of this syllabus for handy reference. Whenever there is a question about what assignments are due, please remember this syllabus is considered the ruling document. Copyright Copyright ©2009 by University of Phoenix. All rights reserved. University of Phoenix© is a registered trademark of Apollo Group, Inc. in the United States and/or other countries. Microsoft©, Windows©, and Windows NT© are registered trademarks of Microsoft Corporation in the United States and/or other countries. All other company and product names are trademarks or registered trademarks of their respective companies. Use of these marks is not intended to imply endorsement, sponsorship, or affiliation. Edited in accordance with University of Phoenix© editorial standards and practices. Facilitator Information Susan Smillie smillies@email.phoenix.edu (University of Phoenix) srsmillie@yahoo.com (Personal) 630-833-5758 (CST) Facilitator Availability I will be available in...
Words: 5620 - Pages: 23
...According to the Mayfield Handbook of Technical and Scientific Writing (2001), there are five characteristics that define effective technical communication; accuracy, clarity, conciseness, coherence, and appropriateness. For material that emphasizes clarity and conciseness, I find that section 1.1 of the Mayfield Handbook website falls short of delivering the material in such manners. These five characteristics will be used to provide an evaluative summation of the material. Accuracy in technical writing is comprised of three components; document accuracy, stylistic accuracy, and technical accuracy. Document accuracy refers to “proper coverage of your topics in appropriate detail” (Perelman, Barrett, & Paradis, 2001, p. section 1.1.1.). There must be a clearly defined problem statement, which is addressed with relevant data. Next, there is stylistic accuracy, which concerns appropriate use of language. This refers to the use of proper paragraph and sentence structure, as well as word choice that is effective in describing the topics. Finally, there is technical accuracy, which is shaped by the writer’s knowledge of the subject and the ability to analyze data without distorting the facts. The Mayfield Handbook does have proper document accuracy. The subject matter is relevant to technical writing. Stylistic accuracy is where the material is lacking. There is poor sentence structure and wording throughout the material. Simple proofreading would...
Words: 579 - Pages: 3
...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
... let me give you simple facts about my name. Based on my research, the name Allen means noble and fair while my last name de los Reyes means royal. So what are we waiting for? Let’s now play TEXT TWIST. Technical writing, a form of technical communication, is a style of writing used in fields as diverse as computer hardware and software, engineering, chemistry, the aerospace industry, robotics, finance, consumer electronics, and biotechnology. [ Technical writers begin by forming a clear understanding of the purpose of the document they will create. If payment for production comes from a second party, this includes a detailed interview with the party that pays for the document's production. Technical writers then typically go on to gather information from existing documentation and from subject matter experts. A subject matter expert (SME) is any expert on the topic that the writer is working on. Technical writers are often not SMEs themselves (unless they are writing about creating good technical documentation). Workers at many levels, and in many different fields, have a role in producing technical communications. A good technical writer needs strong language and teaching skills and must understand the many conventions of modern technical communications. Technical writing teams or departments are often...
Words: 2194 - Pages: 9
...HOW TO WRITE A TECHNICAL REPORT by Alan Smithee A report submitted in partial fulfillment of the requirements for ME 000 Some Course Department of Mechanical Engineering Fictitious Institute of Technology 01 January 9999 ABSTRACT Mechanics of writing a technical report is explained in a pseudo report format. The purpose of this pseudo report is to explain the contents of a typical engineering report. It can also be used as a template for an actual engineering report. With some adaptation, the format can be extended to other type of technical writings as well. TABLE OF CONTENTS ABSTRACT ................................................................................................................................i LIST OF FIGURES AND TABLES ......................................................................................... iii LIST OF SYMBOLS .................................................................................................................iv ACKNOWLEDGEMENTS ........................................................................................................v INTRODUCTION ......................................................................................................................1 EXPERIMENTAL DETAILS.....................................................................................................1 RESULTS AND DISCUSSIONS................................................................................................2 SECTION DESCRIPTIONS...
Words: 3413 - Pages: 14
...Hamad Instructor: Robert Hodges Date submitted: 10/24/2010 University of Phoenix Material Workplace Communication Comparison Complete the following matrix. For each communication method, list its purpose in the workplace, whether it is a technical or expository form of written communication, and why you classified it as such. |Written communication method |Purpose in the workplace |Technical or |Why classification was chosen | | | |expository writing| | |E-mail |Can be types of electronic|Technical writing |we can | | |communication are quick | |attach documents, Web links, graphics, and sound| | |and can almost be | |and movie | | |synchronous. | |Files for review. | |Memos |Use it as internal |Technical writing |We can attach or Enclose documents. | | |correspondence to one or | | | | |several ...
Words: 677 - Pages: 3
...Hamad Instructor: Robert Hodges Date submitted: 10/24/2010 University of Phoenix Material Workplace Communication Comparison Complete the following matrix. For each communication method, list its purpose in the workplace, whether it is a technical or expository form of written communication, and why you classified it as such. |Written communication method |Purpose in the workplace |Technical or |Why classification was chosen | | | |expository writing| | |E-mail |Can be types of electronic|Technical writing |we can | | |communication are quick | |attach documents, Web links, graphics, and sound| | |and can almost be | |and movie | | |synchronous. | |Files for review. | |Memos |Use it as internal |Technical writing |We can attach or Enclose documents. | | |correspondence to one or | | | | |several ...
Words: 677 - Pages: 3
...The Internship Report Rationale ∗ (Eng 498/698) Because the student who does an internship receives credit from the university, graded credit determined by the technical writing faculty, there needs to be documentation in addition to the site supervisor's evaluation as a basis for that graded credit. Submitting an internship report not only provides the faculty with a document which qualifies the student for graded credit, it also provides the faculty with in-depth information about the profession they are responsible for preparing students to participate in. Furthermore, and of considerable importance, the internship report increases the student's responsibility by requiring the student intern to gather information and plan the report throughout the work experience. The student then has an opportunity to demonstrate maturity as a technical writer by presenting, analyzing, and evaluating his or her own work on the job. Report Content and Format The internship report comprises four parts, each involving a different kind of information and a different mode of written discourse: (1) introduction, (2) narrative, (3) analysis and evaluation, and (4) appendix. Introduction The introduction explains the setting where the work was accomplished and gives a sense of how the intern's job related to the entire work of the hiring organization. This section lends itself to the inverted pyramid organization, moving from general information about the entire organization to a specific...
Words: 931 - Pages: 4
...Student, overall, you need to review chapter 15 on developing and writing analytical reports. You have some good information; however your report should be in professional business format and style. You need to use at least one or two supporting figures. Also, you are missing your letter of transmittal and your list of six references. Please review my comments within your report. Missing Letter of Transmittal. Information Technology Career Paths Recommendations and explanations of I.T. career paths for college students Student Last Name Job Title Energy Company 2222 East San Louis Pkwy Hewitt, Texas 77032 Contents Review Chapter 15 of your text for correct format. Also, review the sample format for a TOC in Week Six Questions and Concerns thread. Executive Summary……………..………………………………………………………………….iv Introduction…………………………………………………………………………….………………1 Diversity is Key………………………………………………………………………….………….....2 What is my passion……….……………………………………………………………….…………2 Conclusion……………………………………………………………………….………………………2 Recommendation…………………………………………………………………….……………….2 Executive Summary This report analyzes [Avoid anthropomorphisms (attributing human characteristics to nonhuman or inanimate objects). Consider that no report can "analyze."] the differences between an executive management career and a technical career in the information technology field. Diversity Is Key To a Healthy Career ...
Words: 2073 - Pages: 9