Instructions from Devs

Subject: Instructions from Devs
From: Mike McCallister <mike -dot- mccallister -at- pkware -dot- com>
To: "techwr-l -at- lists -dot- techwr-l -dot- com (techwr-l -at- lists -dot- techwr-l -dot- com) (techwr-l -at- lists -dot- techwr-l -dot- com)" <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Tue, 10 Mar 2015 15:25:22 +0000

One of our developers sent this link to a blog post titled: "The more times you use the word "simply" in your instructions, the more I suspect you don't know what that word means":

http://blogs.msdn.com/b/oldnewthing/archive/2015/03/10/10598846.aspx

Fave quote: "But this person lived in a world where dropping to a command prompt, running a magic command, extracting the right voodoo code from the cryptic output, running a second magic command, then editing a configuration file, and then running a third magic command for the changes to take effect is a perfectly simple operation."


Mike McCallister
Senior Document Architect



PKWARE, Inc.
201 E. Pittsburgh Ave.
Suite 400
Milwaukee, WI 53204
Direct: 414-289-9788 x1136
www.pkware.com


^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Adobe TCS 5: Get the Best of both worlds: modern publishing and best in class XML \ DITA authoring | http://adobe.ly/scpwfT

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-

To unsubscribe send a blank email to
techwr-l-leave -at- lists -dot- techwr-l -dot- com


Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit
http://www.techwhirl.com/email-discussion-groups/ for more resources and info.

Looking for articles on Technical Communications? Head over to our online magazine at http://techwhirl.com

Looking for the archived Techwr-l email discussions? Search our public email archives @ http://techwr-l.com/archives


Follow-Ups:

Previous by Author: Re: PDF link checker?
Next by Author: Re: âRe: Differentiating between software versions in help articles
Previous by Thread: Re: Replacement for "mix-and-match"
Next by Thread: Re: Instructions from Devs


What this post helpful? Share it with friends and colleagues:

Sponsored Ads


Sponsored Ads