The Art of Technical Documentation

The Art of Technical Documentation
Author: Katherine Haramundanis
Publisher: Digital Press
Total Pages: 287
Release: 2014-05-16
Genre: Computers
ISBN: 1483184013

The Art of Technical Documentation presents concepts, techniques, and practices in order to produce effective technical documentation. The book provides the definition of technical documentation; qualities of a good technical documentation; career paths and documentation management styles; precepts of technical documentation; practices for gathering information, understanding what you have gathered, and methods for testing documentation; and considerations of information representation, to provide insights on how different representations affect reader perception of your documents. Technical writers and scientists will find the book a good reference material.

The Product is Docs

The Product is Docs
Author: Christopher Gales
Publisher:
Total Pages: 287
Release: 2020
Genre: New products
ISBN:

This book provides a broad perspective about the essential aspects of creating technical documentation in today's product development world. It is a book of opinions and guidance, collected as short essays. You can read selectively about subjects that interest you, or you can read the entire collection in any order you like. Information development is a multidimensional discipline, and it is easy to theorize. We have written this book from our direct experience, using the concrete insights and practices we apply to our work every day. If you work as an information developer, a manager in a documentation team, or in another part of product development that collaborates with a doc team, there is information in this book for you. Perhaps you are a technical writer in a small, high-growth company that is figuring out its processes. Perhaps you are an information-development manager in a large enterprise company with an expanding product line and an ever more complex matrix of cross-functional dependencies. You might work at a medium-sized company where your management is asking you to do more with fewer people, and you want some additional perspective that will help you find a leaner and more effective way to deliver what your business demands. Or you might work outside the technical documentation world, in another part of product development, and are wondering how to collaborate most effectively with the documentation team. The purpose of The Product is Docs is to provoke discussion, shine light on some murky areas, and--we hope--inspire our colleagues to consider their processes and assumptions with new eyes. -- Amazon.

Technical Writing Process

Technical Writing Process
Author: Kieran Morgan
Publisher: Technical Writing Process
Total Pages: 0
Release: 2015
Genre: Communication of technical information
ISBN: 9780994169310

"Plan, structure, write, review, publish"--Cover.

Docs for Developers

Docs for Developers
Author: Jared Bhatti
Publisher: Apress
Total Pages: 0
Release: 2021-10-01
Genre: Computers
ISBN: 9781484272169

Learn to integrate programming with good documentation. This book teaches you the craft of documentation for each step in the software development lifecycle, from understanding your users’ needs to publishing, measuring, and maintaining useful developer documentation. Well-documented projects save time for both developers on the project and users of the software. Projects without adequate documentation suffer from poor developer productivity, project scalability, user adoption, and accessibility. In short: bad documentation kills projects. Docs for Developers demystifies the process of creating great developer documentation, following a team of software developers as they work to launch a new product. At each step along the way, you learn through examples, templates, and principles how to create, measure, and maintain documentation—tools you can adapt to the needs of your own organization. What You'll Learn Create friction logs and perform user research to understand your users’ frustrations Research, draft, and write different kinds of documentation, including READMEs, API documentation, tutorials, conceptual content, and release notes Publish and maintain documentation alongside regular code releases Measure the success of the content you create through analytics and user feedback Organize larger sets of documentation to help users find the right information at the right time Who This Book Is For Ideal for software developers who need to create documentation alongside code, or for technical writers, developer advocates, product managers, and other technical roles that create and contribute to documentation for their products and services.

Technical Translation

Technical Translation
Author: Jody Byrne
Publisher: Springer Science & Business Media
Total Pages: 290
Release: 2006-06-23
Genre: Language Arts & Disciplines
ISBN: 1402046537

This introduction to technical translation and usability draws on a broad range of research and makes the topic both accessible and applicable to those involved in the practice and study of translation. Readers learn how to improve and assess the quality of technical translations using cognitive psychology, usability engineering and technical communication. A practical usability study illustrates the theories, methods and benefits of usability engineering.

The Elements of Technical Writing

The Elements of Technical Writing
Author: Gary Blake
Publisher: MacMillan Publishing Company
Total Pages: 202
Release: 1993
Genre: Reference
ISBN:

The authors of The Elements of Business Writing present all the essentials of writing clear, coherent technical reports, proposals, and documents in an accessible style and concise, easy-to-use format. Covers writing and grammar skills and offers dozens of examples and sample reports.

How to Communicate Technical Information

How to Communicate Technical Information
Author: Jonathan Price
Publisher: Addison-Wesley Professional
Total Pages: 458
Release: 1993
Genre: Computers
ISBN:

In How to Communicate Technical Information, you will learn how to write printed and online computer documentation that is simple, clear, interesting and user-friendly. Technical writers Jonathan Price and Henry Korman map out easy-to-follow methods and include practical tips to help you create hardware and software documentation that is accessible to both beginning and experienced end-users. How to Communicate Technical Information: - Discusses easy-to-follow and user-friendly ways of organizing information. - Demonstrates how to use the art to communicate context, multiple options and results. - Offers new ways to present both quick start options for experienced users and installation instructions. - Presents effective new methods for supplying computer-based training (CBT), including sophisticated graphic and hypertext tours, and demonstrations. - Includes information on online help that suggests methods for integrating this feature into your documentation. Throughout the book, the authors share the techniques they present in their popular seminars as they provide straightforward and interesting ways of organizing information. Price and Korman also suggest practical methods for developing good writing styles. 0805368299B04062001

Agile Documentation

Agile Documentation
Author: Andreas Rüping
Publisher: John Wiley & Sons
Total Pages: 244
Release: 2005-01-14
Genre: Computers
ISBN: 0470856246

Software documentation forms the basis for all communication relating to a software project. To be truly effective and usable, it should be based on what needs to be known. Agile Documentation provides sound advice on how to produce lean and lightweight software documentation. It will be welcomed by all project team members who want to cut out the fat from this time consuming task. Guidance given in pattern form, easily digested and cross-referenced, provides solutions to common problems. Straightforward advice will help you to judge: What details should be left in and what left out When communication face-to-face would be better than paper or online How to adapt the documentation process to the requirements of individual projects and build in change How to organise documents and make them easily accessible When to use diagrams rather than text How to choose the right tools and techniques How documentation impacts the customer Better than offering pat answers or prescriptions, this book will help you to understand the elements and processes that can be found repeatedly in good project documentation and which can be shaped and designed to address your individual circumstance. The author uses real-world examples and utilises agile principles to provide an accessible, practical pattern-based guide which shows how to produce necessary and high quality documentation.

Handbook of Technical Writing

Handbook of Technical Writing
Author: Charles T. Brusaw
Publisher: St. Martin's Press
Total Pages: 832
Release: 1997-08-15
Genre: Technology & Engineering
ISBN: 9780312166908

New to this edition: Up-to-date information on on-line research and computer resources. A unique four-way access system enables users of the Handbook of Technical Writing to find what they need quickly and get on with the job of writing: 1. The hundreds of entries in the body of the Handbook are alphabetically arranged, so you can flip right to the topic at hand. Words and phrases in bold type provide cross-references to related entries. 2. The topical key groups alphabetical entries and page numbers under broader topic categories. This topical table of contents allows you to check broader subject areas for the specific topic you need. 3. The checklist of the writing process summarizes the opening essay on "Five Steps to Successful Writing" in checklist form with page references to related topics, making it easy to use the Handbook as a writing text. 4. The comprehensive index provides an exhaustive listing of related and commonly confused topics, so you can easily locate information even when you don't know the exact term you're looking for.

Designing and Writing Online Documentation

Designing and Writing Online Documentation
Author: William Horton
Publisher:
Total Pages: 472
Release: 1994-11-07
Genre: Computers
ISBN:

The #1 guide to creating effective online documentation is now updated and expanded to reflect the latest technological advances, including multimedia. "...online documentation is a different medium, as different from books as television is from radio or movies from novels. This edition treats online documentation as the new electronic medium it is." -William Horton Written by an internationally renowned pioneer in the field of technical communication, this is an incomparable guide to the art and science of creating online documents and documentation systems. Rather than concentrating on any one particular program or operating system, William Horton cuts to the heart of effective human-computer interaction and extrapolates a set of universal principles that can be applied to any form of online documentation-from messages, menus, and help files, to computer tutorials and hypertexts. Maintaining an end-user's perspective throughout, he guides you step by step through every crucial design decision without ever losing sight of the final goal-clear, effective online documentation that people enjoy using. Proven techniques that help reduce support and training costs for software products, eliminate the need for paper documentation, make programs more appealing and easier to use, and more * A practical, hands-on approach, supported by the latest research and supplemented with dozens of case studies and illustrations * Includes new chapters on multimedia and computer-based training * Comprehensive coverage of all online documentation media-words, graphics, animation, and sound * Updated information on organizing and structuring documents-with examples from Windows, OS/2, and Macintosh interfaces