Developing Quality Technical Information

Developing Quality Technical Information
Author: Michelle Carey
Publisher: Pearson Education
Total Pages: 612
Release: 2014
Genre: Computers
ISBN: 0133118975

Drawing on IBM's unsurpassed technical communications experience, readers discover today's best practices for meeting nine quality characteristics: accuracy, clarity, completeness, concreteness, organization, retrievability, style, task orientation, and visual effectiveness. Packed with guidelines, checklists, and before-and-after examples, Developing Quality Technical Information, Third Edition is an indispensable resource for the future of technical communication.

Developing Quality Technical Information

Developing Quality Technical Information
Author: Gretchen Hargis
Publisher: Pearson Education
Total Pages: 550
Release: 2004-04-06
Genre: Technology & Engineering
ISBN: 0137034784

"The examples are excellent--right on target and easy to understand and adapt. Even those who don't adopt the entire procedure can profit from the parts, but the greatest value will flow to those who adopt the whole." --Carolyn Mulford, senior writer and editor of Writing That Works "This is also a book that students can keep for their professional libraries because it will increase in its value to them after they leave class and face real life experiences on the job. It is plain enough for them to understand while they are learning, and at the same time comprehensive enough to support them as professionals." --Elizabeth Boling, Instructional Systems Technology, Indiana University "It practices what it preaches. Its guidelines are understandable and appropriate; its examples clear. It contains exactly what writers and editors need to know. It is the book that I would have written." --Cynthia E. Spellman, Unisys The #1 guide to excellence in documentation--now completely updated! A systematic, proven approach to creating great documentation Thoroughly revised and updated More practical examples More coverage of topic-based information, search, and internationalization Direct from IBM's own documentation experts, this is the definitive guide to developing outstanding technical documentation--for the Web and for print. Using extensive before-and-after examples, illustrations, and checklists, the authors show exactly how to create documentation that's easy to find, understand, and use. This edition includes extensive new coverage of topic-based information, simplifying search and retrievability, internationalization, visual effectiveness, and much more. Coverage includes: Focusing on the tasks and topics users care about most Saying more with fewer words Using organization and other means to deliver faster access to information Presenting information in more visually inviting ways Improving the effectiveness of your review process Learning from example: sample text, screen captures, illustrations, tables, and much more Whether you're a writer, editor, designer, or reviewer, if you want to create great documentation, this book shows you how!

DITA Best Practices

DITA Best Practices
Author: Laura Bellamy
Publisher: IBM Press
Total Pages: 266
Release: 2012
Genre: Computers
ISBN: 0132480522

&>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

Developing High Quality Data Models

Developing High Quality Data Models
Author: Matthew West
Publisher: Elsevier
Total Pages: 408
Release: 2011-02-07
Genre: Computers
ISBN: 0123751071

Developing High Quality Data Models provides an introduction to the key principles of data modeling. It explains the purpose of data models in both developing an Enterprise Architecture and in supporting Information Quality; common problems in data model development; and how to develop high quality data models, in particular conceptual, integration, and enterprise data models. The book is organized into four parts. Part 1 provides an overview of data models and data modeling including the basics of data model notation; types and uses of data models; and the place of data models in enterprise architecture. Part 2 introduces some general principles for data models, including principles for developing ontologically based data models; and applications of the principles for attributes, relationship types, and entity types. Part 3 presents an ontological framework for developing consistent data models. Part 4 provides the full data model that has been in development throughout the book. The model was created using Jotne EPM Technologys EDMVisualExpress data modeling tool. This book was designed for all types of modelers: from those who understand data modeling basics but are just starting to learn about data modeling in practice, through to experienced data modelers seeking to expand their knowledge and skills and solve some of the more challenging problems of data modeling. - Uses a number of common data model patterns to explain how to develop data models over a wide scope in a way that is consistent and of high quality - Offers generic data model templates that are reusable in many applications and are fundamental for developing more specific templates - Develops ideas for creating consistent approaches to high quality data models

Handbook of Analytical Quality by Design

Handbook of Analytical Quality by Design
Author: Sarwar Beg
Publisher: Academic Press
Total Pages: 225
Release: 2021-01-09
Genre: Science
ISBN: 0128203331

Handbook of Analytical Quality by Design addresses the steps involved in analytical method development and validation in an effort to avoid quality crises in later stages. The AQbD approach significantly enhances method performance and robustness which are crucial during inter-laboratory studies and also affect the analytical lifecycle of the developed method. Sections cover sample preparation problems and the usefulness of the QbD concept involving Quality Risk Management (QRM), Design of Experiments (DoE) and Multivariate (MVT) Statistical Approaches to solve by optimizing the developed method, along with validation for different techniques like HPLC, UPLC, UFLC, LC-MS and electrophoresis. This will be an ideal resource for graduate students and professionals working in the pharmaceutical industry, analytical chemistry, regulatory agencies, and those in related academic fields. - Concise language for easy understanding of the novel and holistic concept - Covers key aspects of analytical development and validation - Provides a robust, flexible, operable range for an analytical method with greater excellence and regulatory compliance

The IBM Style Guide

The IBM Style Guide
Author: Francis DeRespinis
Publisher: IBM Press
Total Pages: 413
Release: 2012
Genre: Computers
ISBN: 0132101300

Straight from IBM: complete, proven guidelines for writing consistent, clear, concise, consumable, reusable, and easy to- translate content Brings together everything IBM has learned about writing outstanding technical and business content.

Technical Documentation and Process

Technical Documentation and Process
Author: Jerry C. Whitaker
Publisher: CRC Press
Total Pages: 195
Release: 2018-09-03
Genre: Technology & Engineering
ISBN: 1439861609

We live in an age of electronic interconnectivity, with co-workers across the hall and across the ocean, and managing meetings can be a challenge across multiple time zones and cultures. This makes documenting your projects more important than ever. In Technical Documentation and Process, Jerry Whitaker and Bob Mancini provide the background and structure to help you document your projects more effectively. With more than 60 years of combined experience in successfully documenting complex engineering projects, the authors guide you in developing appropriate process and documentation tools that address the particular needs of your organization. Features Strategies for documenting a project, product, or facility A sample style guide template—the foundation on which you can build documents of various types A selection of document templates Ideas for managing complex processes and improving competitiveness using systems engineering and concurrent engineering practices Basic writing standards and helpful references Major considerations for disaster planning Discussion of standardization to show how it can help reduce costs Helpful tips to manage remote meetings and other communications First-hand examples from the authors’ own experience Throughout, the authors offer practical guidelines, suggestions, and lessons that can be applied across a wide variety of project types and organizational structures. Comprehensive yet to the point, this book helps you define the process, document the plan, and manage your projects more confidently.

Real-World Solutions for Developing High-Quality PHP Frameworks and Applications

Real-World Solutions for Developing High-Quality PHP Frameworks and Applications
Author: Sebastian Bergmann
Publisher: John Wiley & Sons
Total Pages: 408
Release: 2011-04-18
Genre: Computers
ISBN: 1118098242

Learn to develop high-quality applications and frameworks in PHP Packed with in-depth information and step-by-step guidance, this book escorts you through the process of creating, maintaining and extending sustainable software of high quality with PHP. World-renowned PHP experts present real-world case studies for developing high-quality applications and frameworks in PHP that can easily be adapted to changing business requirements. . They offer different approaches to solving typical development and quality assurance problems that every developer needs to know and master. Details the process for creating high-quality PHP frameworks and applications that can easily be adapted to changing business requirements Covers the planning, execution, and automation of tests for the different layers and tiers of a Web application Demonstrates how to establish a successful development process Shares real-world case studies from well-known companies and their PHP experts With this book, you’ll learn to develop high-quality PHP frameworks and applications that can easily be maintained with reasonable cost and effort.