Modern Technical Writing: An Introduction to Software Documentation

£3.00

This slender volume provides the foundational knowledge to start creating and publishing great software documentation. Written by the lead technical writer at one of Silicon Valley’s most exciting companies, Modern Technical Writing is a set of guiding principles and thoughtful recommendations for new and experienced technical writers alike. Not a reference manual, and not comprehensive, it instead serves as an introduction to a sensible writing and publishing process, one that has eluded the profession for too long.

Read more

Buy product
EAN: 2000000326641 SKU: 09CB6869 Category:

Additional information

Language

English

File size

301 KB

Simultaneous device usage

Unlimited

Text-to-Speech

Enabled

Screen Reader

Supported

Enhanced typesetting

Enabled

X-Ray

Not Enabled

Word Wise

Not Enabled

Sticky notes

On Kindle Scribe

Print length

52 pages

Average Rating

3.67

03
( 3 Reviews )
5 Star
33.33%
4 Star
0%
3 Star
66.67%
2 Star
0%
1 Star
0%

Only logged in customers who have purchased this product may leave a review.

3 Reviews For This Product

  1. 03

    by Christian Mogensen

    Covers the basics well.. practical examples show the beginner how to get started with static site builders, git, markdown and ascii-doc.

  2. 03

    by R. D. Eager

    The publication date is not shown. This makes me a little suspicious.

  3. 03

    by Dee Vincent-Day

    I am currently researching methods of technical documentation production and found this book an interesting read. However I do not agree that this is the best method. Whilst markdown allows more people to contribute it does not talk about how you manage the readability of text and maintaining a clear “Global” English writing style. It talks of the complexities of managing translations but again does not offer a “Global” English approach which in my experience considerably aids translation. To me the Technical Communicator’s role is about bridging the gap between the developers and the customer. This requires skilled writers of English who understand how to write for global audiences. I have looked at Markdown but feel that the management of topic files, and the intervention required to produce tables and conditional text, would make use of this method very time consuming. It would not be workable for large scale global SAAS systems requiring translations to several languages, nor for systems where you are producing several builds, branded for different customers, where you are extensively using conditional text for custom implementations. However, If there were a choice to be made, I would prefer to use markdown over Word. In essence, if a technical writer has used professional tools tools such as Adobe Technical Communications Suite or Madcap Flare, giving them markdown is like trading down from Photoshop to Paintbrush.

Main Menu

Modern Technical Writing: An Introduction to Software Documentation