Author: Mark Baker
Publisher: XML Press
Release Date: 2013-12-03
The Web changes how people use content; not just content on the Web, but all content. If your content is not easy to find and immediately helpful, readers will move on almost at once. We are all children of the Web, and we come to any information system, including product documentation, looking for the search box and expecting every search to work like Google. There is no first, last, previous, next, up, or back anymore. Every Page is Page One. In this ground-breaking book, Mark Baker looks beyond the usual advice on writing for the Web, and beyond the idea of topic-based writing merely as an aid to efficiency and reuse, to explore how readers really use information in the age of the Web and to lay out an approach to planning, creating, managing, and organizing topic-based documentation that really works for the reader.
Author: John Millar Carroll
Publisher: MIT Press
Release Date: 1998-01
Minimalism is an action- and task-oriented approach to instruction and documentation that emphasizes the importance of realistic activities and experiences for effective learning and information seeking. Since 1990, when the approach was defined in John Carroll's The Nurnberg Funnel, much work has been done to apply, refine, and broaden the minimalist approach to technical communication. This volume presents fourteen major contributions to the current theory and practice of minimalism. Contributors evaluate the development of minimalism up to now, analyze the acceptance of minimalism by the mainstream technical communications community, report on specific innovations and investigations, and discuss future challenges and directions. The book also includes an appendix containing a bibliography of published research and development work on minimalism since 1990. Contributors: Tricia Anson, R. John Brockmann, John M. Carroll, Steve Draper, David K. Farkas, JoAnn T. Hackos, Robert R. Johnson, Greg Kearsley, Barbara Mirel, Janice (Ginny) Redish, Stephanie Rosenbaum, Karl L. Smart, Hans van der Meij. Published in association with the Society for Technical Communication .
The #1 Guide to Excellence in Technical Communication—Fully Updated for Embedded Assistance, Mobile, Search, Multimedia, and More Direct from IBM’s own content design experts, this guide shows you how to design product interfaces and technical information that always place users front and center. This edition has been fully revised to help you consistently deliver the right content at the right time. You’ll master today’s best practices to apply nine essential characteristics of high-quality technical information: accuracy, clarity, completeness, concreteness, organization, retrievability, style, task orientation, and visual effectiveness. Coverage Includes Advocating for users throughout the entire product development process Delivering information in an ordered manner by following progressive disclosure techniques Optimizing content so that users can find it from anywhere Streamlining information for mobile delivery Helping users right where they are Whether you’re a writer, editor, information architect, user experience professional, or reviewer, this book shows you how to create great technical information, from the product design to the user interface, topics, and other media. Thoroughly revised and updated Extensive new coverage of self-documenting interfaces and embedded assistance Updated practical guidelines and checklists Hundreds of new examples
The Start-to-Finish, Best-Practice Guide to Implementing and Using DITA Darwin Information Typing Architecture (DITA) is today’s most powerful toolbox for constructing information. By implementing DITA, organizations can gain more value from their technical documentation than ever before. Now, three DITA pioneers offer the first complete roadmap for successful DITA adoption, implementation, and usage. Drawing on years of experience helping large organizations adopt DITA, the authors answer crucial questions the “official” DITA documents ignore, including: Where do you start? What should you know up front? What are the pitfalls in implementing DITA? How can you avoid those pitfalls? The authors begin with topic-based writing, presenting proven best practices for developing effective topics and short descriptions. Next, they address content architecture, including how best to set up and implement DITA maps, linking strategies, metadata, conditional processing, and content reuse. Finally, they offer “in the trenches” solutions for ensuring quality implementations, including guidance on content conversion. Coverage includes: Knowing how and when to use each DITA element–and when not to Writing “minimalist,” task-oriented information that quickly meets users’ needs Creating effective task, concept, and reference topics for any product, technology, or service Writing effective short descriptions that work well in all contexts Structuring DITA maps to bind topics together and provide superior navigation Using links to create information webs that improve retrievability and navigation Gaining benefits from metadata without getting lost in complexity Using conditional processing to eliminate redundancy and rework Systematically promoting reuse to improve quality and reduce costs Planning, resourcing, and executing effective content conversion Improving quality by editing DITA content and XML markup¿ If you’re a writer, editor, information architect, manager, or consultant who evaluates, deploys, or uses DITA, this book will guide you all the way to success. Also see the other books in this IBM Press series: Developing Quality Technical Information: A Handbook for Writers and Editors The IBM Style Guide: Conventions for Writers and Editors
Author: Johndan Johnson-Eilola
Publisher: University of Chicago Press
Release Date: 2012-12-26
The field of technical communication is rapidly expanding in both the academic world and the private sector, yet a problematic divide remains between theory and practice. Here Stuart A. Selber and Johndan Johnson-Eilola, both respected scholars and teachers of technical communication, effectively bridge that gap. Solving Problems in Technical Communication collects the latest research and theory in the field and applies it to real-world problems faced by practitioners—problems involving ethics, intercultural communication, new media, and other areas that determine the boundaries of the discipline. The book is structured in four parts, offering an overview of the field, situating it historically and culturally, reviewing various theoretical approaches to technical communication, and examining how the field can be advanced by drawing on diverse perspectives. Timely, informed, and practical, Solving Problems in Technical Communication will be an essential tool for undergraduates and graduate students as they begin the transition from classroom to career.
'I wish we'll have two children called Mark and Harriet. And I hope lots of interesting and unusual things will happen to them. It would be nice if they had a fairy godmother, for instance. And a phoenix or something out of the ordinary for a pet. We could have a special day for interesting and unusual things to happen - say, Mondays. But not always Mondays, and not only Mondays, or that would get a bit dull' As a result of their mother's honeymoon wish, Mark and Harriet Armitage have a fairy godmother, a pet unicorn, and are prepared for anything life can throw at them (especially, but not always, on a Monday): hatching griffins in the airing cupboard, Latin lessons with a ghost, furious Furies on the doorstep, and an enchanted garden locked inside a cereal packet. Life with the Armitages can be magical, funny, terrifying - but never, ever dull.
Author: William S. Pfeiffer
Publisher: Pearson Higher Ed
Release Date: 2011-11-21
Genre: Technology & Engineering
This is the eBook of the printed book and may not include any media, website access codes, or print supplements that may come packaged with the bound book. Technical Communication Fundamentals presents proven writing strategies in a format that is concise and easy to use. Designed for flexibility, the book is supported by MyTechCommLab, which provides 90 model documents, 50 interactive documents, tutorials, activities, and case studies all on The Web! Using numbered guidelines, an ABC format and annotated samples, the book immerses students in the process of technical writing, while teaching practical formats for getting the job done.
"Learn how to have great conversations through your site or app. Meet your business goals while satisfying your site visitors' needs. Learn how to create useful and usable content from the master - Ginny Redish. Ginny's easy-to-read style will teach you how to plan, organize, write, design, and test your content"--
Author: Stephen R. Covey
Publisher: FT Press
Release Date: 2012-06-07
Genre: Business & Economics
FranklinCovey Style Guide: For Business and Technical Communication can help any writer produce documents that achieve outstanding results. Created by FranklinCovey, the world-renowned leader in helping organizations enhance individual effectiveness, this edition fully reflects today’s online media and global business challenges. The only style guide used in FranklinCovey’s own renowned Writing AdvantageTM and Technical Writing AdvantageTM programs, it covers everything from document design and graphics to sentence style and word choice. This edition’s many improvements include extensive new coverage of graphics, writing for online media, and international business English. Through dozens of examples and model documents, writers learn how to overcome “writer’s block” and efficiently create documents from start to finish. FranklinCovey’s experts show how to get powerful results from every email; add distinctiveness and power to any online presence; write far more effective proposals, letters, memos, reports, and resumes; and improve all forms of documentation, from business procedures to highly technical content. You’ll learn how to quickly discover and prioritize the information you need, whether you’re planning a presentation, leading a meeting, or managing a project. The authors reveal how to design visuals that communicate messages instantly and intuitively, and use charts, color, illustrations, maps, photos, and tables to supercharge any presentation. Packed with up-to-the-minute examples, this A-Z guidebook can help you write more effectively no matter who you are — whether you’re a business or sales professional who must motivate and persuade, a technical professional who must explain challenging content more clearly and accurately, or a student who needs stronger writing skills to succeed in school and in your career.
Author: Leigh W. White
Publisher: XML Press
Release Date: 2017-02-16
As DITA has become more and more popular, demand has increased for tools thatcan provide high quality PDFs from DITA content. The DITA Open Toolkit providesa basic PDF capability, but nearly any real-world application will require customization.Leigh White's book, DITA for Print has become the go-to reference for building aprint customization plugin for the DITA Open Toolkit. This second edition coversOpen Toolkit, version 2, including customizing the DITA 1.3 troubleshooting topictype, localization strings, bookmarks, and the new back-cover functionality.DITA for Print is for anyone who wants to learn how to create PDFs using the DITAOpen Toolkit without learning everything there is to know about XSL-FO, XSLT, orXPath, or even about the DITA Open Toolkit itself. DITA for Print is written for nonprogrammers,by a non-programmer, and although it is written for people who have agood understanding of the DITA standard, you don't need a technical background toget custom PDFs up and running quickly.
Author: Paul V. Anderson
Publisher: Cengage Learning
Release Date: 2016-12-05
Genre: Language Arts & Disciplines
Faculty have used Anderson's TECHNICAL COMMUNICATION: A READER-CENTERED APPROACH to prepare thousands of students for the writing they will do in their careers. Known for its rhetorical treatment of workplace writing and speaking, this text helps students learn practical, flexible strategies for creating useful and persuasive communications on the job. Reorganized and streamlined to enhance student learning, the ninth edition includes greatly expanded attention to social media. It also introduces to technical communication pedagogy a set of exercises and instruction that help students transfer their technical communication knowledge and skills from school to workplace. Important Notice: Media content referenced within the product description or the product text may not be available in the ebook version.
Author: Johndan Johnson-Eilola
Publisher: Oxford University Press, USA
Release Date: 2004
Genre: Language Arts & Disciplines
Bringing together thirty-two landmark essays, Central Works in Technical Communication provides a broad and representative overview of the field. It introduces students, new teachers, and new practitioners to the community of technical communication as an intellectual and communal endeavor that encompasses such complex theoretical topics as research methods, social issues, and ethics. Editors Johndan Johnson-Eilola and Stuart A. Selber engaged in a comprehensive selection process--including the consultation of a review board of leading teachers and scholars--and have included some of the most influential articles and book chapters published in technical communication over the last twenty-five years. Each essay is accompanied by a reflective piece written by its author specifically for this volume. These commentaries provide context for the essays and allow the authors to add to or challenge their original ideas and resituate them in a contemporary environment. The book also features section introductions written by the editors that offer historical and conceptual approaches to understanding the contributions each work makes to the field of technical communication. Central Works in Technical Communication is organized around eight major conceptual categories: histories, rhetorical perspectives, philosophies and theories, ethical and power issues, research methods, workplace studies, online environments, and pedagogical directions. An alternative table of contents groups the essays into additional categories including collaboration, gender, genre, usability, and visual theory and practice. Ideal for advanced undergraduate and graduate courses in technical communication, this collection is also a compact and convenient resource for practicing professionals and academics new to the field.
Author: Thomas N. Huckin
Publisher: McGraw-Hill Humanities, Social Sciences & World Languages
Release Date: 1991-01
Genre: Business & Economics
Developed for use by non-native speakers of English enrolled in Technical Writing and Communication courses. Technical Writing and Professional Communication, 2/e, places technical writing in its context, showing students how to consider their purpose and their audience when writing reports, memos, and correspondence. Formerly titled Technical Writing and Professional Communication: A Handbook for Nonnative Speakers, the new edition features a case running throughout seven chapters, dynamically illustrating the writing process. The revision also provides complete coverage of the new computer technologies and the new attention to the intercultural concerns in today's business world.
Thoroughly rewritten for today's web environment, this bestselling book offers a fresh look at a fundamental topic of web site development: navigation design. Amid all the changes to the Web in the past decade, and all the hype about Web 2.0 and various "rich" interactive technologies, the basic problems of creating a good web navigation system remain. Designing Web Navigation demonstrates that good navigation is not about technology-it's about the ways people find information, and how you guide them. Ideal for beginning to intermediate web designers, managers, other non-designers, and web development pros looking for another perspective, Designing Web Navigation offers basic design principles, development techniques and practical advice, with real-world examples and essential concepts seamlessly folded in. How does your web site serve your business objectives? How does it meet a user's needs? You'll learn that navigation design touches most other aspects of web site development. This book: Provides the foundations of web navigation and offers a framework for navigation design Paints a broad picture of web navigation and basic human information behavior Demonstrates how navigation reflects brand and affects site credibility Helps you understand the problem you're trying to solve before you set out to design Thoroughly reviews the mechanisms and different types of navigation Explores "information scent" and "information shape" Explains "persuasive" architecture and other design concepts Covers special contexts, such as navigation design for web applications Includes an entire chapter on tagging While Designing Web Navigation focuses on creating navigation systems for large, information-rich sites serving a business purpose, the principles and techniques in the book also apply to small sites. Well researched and cited, this book serves as an excellent reference on the topic, as well as a superb teaching guide. Each chapter ends with suggested reading and a set of questions that offer exercises for experiencing the concepts in action.