The Art of Technical Documentation
The Art of Technical Documentation

Author: Katherine Haramundanis

Publisher: Digital Press

Published: 2014-05-16

Total Pages: 287

ISBN-13: 1483184013

DOWNLOAD EBOOK

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.

Docs Like Code
Docs Like Code

Author: Anne Gentle

Publisher: Lulu.com

Published: 2017-09-09

Total Pages: 118

ISBN-13: 1387081322

DOWNLOAD EBOOK

Looking for a way to invigorate your technical writing team and grow that expertise to include developers, designers, and writers of all backgrounds? When you treat docs like code, you multiply everyone's efforts and streamline processes through collaboration, automation, and innovation. Second edition now available with updates and more information about version control for documents and continuous publishing.

The Product is Docs
The Product is Docs

Author: Christopher Gales

Publisher:

Published: 2020

Total Pages: 287

ISBN-13:

DOWNLOAD EBOOK

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

Published: 2015

Total Pages: 0

ISBN-13: 9780994169310

DOWNLOAD EBOOK

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

Docs for Developers
Docs for Developers

Author: Jared Bhatti

Publisher: Apress

Published: 2021-10-01

Total Pages: 0

ISBN-13: 9781484272169

DOWNLOAD EBOOK

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.

Developing Quality Technical Information
Developing Quality Technical Information

Author: Michelle Carey

Publisher: Pearson Education

Published: 2014

Total Pages: 612

ISBN-13: 0133118975

DOWNLOAD EBOOK

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.

bookdown
bookdown

Author: Yihui Xie

Publisher: CRC Press

Published: 2016-12-12

Total Pages: 140

ISBN-13: 1351792601

DOWNLOAD EBOOK

bookdown: Authoring Books and Technical Documents with R Markdown presents a much easier way to write books and technical publications than traditional tools such as LaTeX and Word. The bookdown package inherits the simplicity of syntax and flexibility for data analysis from R Markdown, and extends R Markdown for technical writing, so that you can make better use of document elements such as figures, tables, equations, theorems, citations, and references. Similar to LaTeX, you can number and cross-reference these elements with bookdown. Your document can even include live examples so readers can interact with them while reading the book. The book can be rendered to multiple output formats, including LaTeX/PDF, HTML, EPUB, and Word, thus making it easy to put your documents online. The style and theme of these output formats can be customized. We used books and R primarily for examples in this book, but bookdown is not only for books or R. Most features introduced in this book also apply to other types of publications: journal papers, reports, dissertations, course handouts, study notes, and even novels. You do not have to use R, either. Other choices of computing languages include Python, C, C++, SQL, Bash, Stan, JavaScript, and so on, although R is best supported. You can also leave out computing, for example, to write a fiction. This book itself is an example of publishing with bookdown and R Markdown, and its source is fully available on GitHub.

Confluence, Tech Comm, Chocolate
Confluence, Tech Comm, Chocolate

Author: Sarah Maddox

Publisher:

Published: 2012

Total Pages: 488

ISBN-13: 9781937434007

DOWNLOAD EBOOK

Takes you inside Confluence wiki for an in-depth guide to developing and publishing technical documentation on a wiki. While the book focuses on Confluence, the concepts and strategies apply to any wiki.

Open Technical Communication
Open Technical Communication

Author: Tamara Powell

Publisher:

Published: 2020-08-19

Total Pages: 399

ISBN-13:

DOWNLOAD EBOOK

"Technical communication is the process of making and sharing ideas and information in the workplace as well as the set of applications such as letters, emails, instructions, reports, proposals, websites, and blogs that comprise the documents you write...Specifically, technical writing involves communicating complex information to a specific audience who will use it to accomplish some goal or task in a manner that is accurate, useful, and clear. Whether you write an email to your professor or supervisor, develop a presentation or report, design a sales flyer, or create a web page, you are a technical communicator." (Chapter 1)