Technical Writing – Use the Method that Untied a 400-year Knot
As a child I grew up only 90 miles away from Polatli, the site of the famous “Knot of Gordian” in Anatolia (what is today modern Turkey). This was such a tough knot that, according to the legend, for 400 years no one could untie it. Then came Alexander the Great, the world-conquering commander with…
Read MoreEliminate Adverbs and Improve Your Writing
© Ugur Akinci You can improve your writing right away by eliminating all the unnecessary adverbs. 1) Eliminate adverbs by using a correct verb instead. EXAMPLE: “He walked into the room cockily.” BETTER: “He swaggered into the room.” EXAMPLE “She walked into the room confidently.” BETTER: “She sashayed into the room.” EXAMPLE: “He looked threateningly.”…
Read MoreInterviewing a Subject Matter Expert (SME)
Introduction A technical writer will periodically need to interview Subject Matter Experts (SME) to gather information about a technical document. More often that not, and especially within the context of software development, most SMEs are engineers and software developers. But they can also be mechanical, electrical and other types of engineers, hardware installers, network engineers,…
Read MoreStewart, Cramer, and the Question of Values in Technical Documentation
© Ugur Akinci Did you watch the way Daily Show’s Jon Stewart grilled Mad Money’s Jim Cramer yesterday? It was a trashing well deserved by Jim Cramer in particular, and CNBC in general. As an American citizen who has lost 40% of all his life savings within the last 9 months, I thought it was…
Read More