Thursday, March 19, 2015

object - deviation

One good convention for subject headers, used by many tech support organizations, is “object - deviation”. The “object” part specifies what thing or group of things is having a problem, and the “deviation” part describes the deviation from expected behavior.


Stupid:

HELP! Video doesn't work properly on my laptop!


Smart:

X.org 6.8.1 misshapen mouse cursor, Fooware MV1005 vid. chipset


Smarter:

X.org 6.8.1 mouse cursor on Fooware MV1005 vid. chipset - is misshapen


The process of writing an “object-deviation” description will help you organize your thinking about the problem in more detail. What is affected? Just the mouse cursor or other graphics too? Is this specific to the X.org version of X? To version 6.8.1? Is this specific to Fooware video chipsets? To model MV1005? A hacker who sees the result can immediately understand what it is that you are having a problem with and the problem you are having, at a glance.







from lizard's ghost http://ift.tt/1Cw1tme

No comments:

Post a Comment