Technical Writing Introduction What’s in store for you this semester Contents • • • • • Purpose of course Technical writing characteristics Technical writing Course requirements Safe computing Definition/Purpose of Course • Technical communication is the “art and science of making complex technical information accessible, usable, and relevant to a variety of audiences in a variety of settings.” • Composition of the types of documents technical professionals write • Review of the planning, drafting, and editing processes • Interaction with new technologies and new environments Accessibility • • • • Accuracy– no errors of fact or grammar Clarity– no ambiguity Completeness– all necessary information is present Diction—appropriate and grammatically correct language • Organization—logical arrangement of parts • Visual effectiveness– page/screen design, graphics Usability • Allows audience to perform the task or retrieve the information they need • Studies design of table of contents, index, headings, etc. • Keeps learning curve short Relevance • Focus on your audience’s need for information. • Give only what’s needed. • Use language that fits your audience and situation and is consistent. On-the-job Writing • Communicate expertise to clients, customers, and the public • Report tech activities to supervisors and others • Write proposals • Instruct lay people • Correspond with colleagues and clients Tech Communicator’s Skills • Facility with language • Use of critical thinking skills to solve problems • Ability to assess situations, determine what the most important issues and the subsidiary ones are • Ability to organize a document that presents the information clearly Skills, continued • Awareness of the persuasive nature of writing and ability to compose documents that convince your reader(s) to act as you suggest or to trust your point of view • Ethical behavior shown by avoiding deceptive graphics, presenting information truthfully, balancing ethical and moral beliefs with the demands of the job Writing Assignments • Application, follow-up letters, and résumés • Technical Definition • Proposal • Collaborative process manual and oral presentation • Product/service comparison • Formal report • Progress Report • Personal and professional website • Class notes • Report outline in PowerPoint. Home Page Creation • Create or update your web site. • Put the pages together manually first • Use an editor or continue to work manually once you’re working on your own. • Link to a web site you already have, adding the requirements for this new part of your site. Safe Computing • Check your own disks for viruses. • Back up your work (you can save on both the S/T drive and a 3.5 floppy/data CD). • Don’t forget to take your disk with you at the end of class. • Put your name, phone number/e-mail address on the label. • Save often; don’t rely on autosave.