{"id":44503,"date":"2015-03-10T07:00:00","date_gmt":"2015-03-10T07:00:00","guid":{"rendered":"https:\/\/blogs.msdn.microsoft.com\/oldnewthing\/2015\/03\/10\/the-more-times-you-use-the-word-simply-in-your-instructions-the-more-i-suspect-you-dont-know-what-that-word-means\/"},"modified":"2015-03-10T07:00:00","modified_gmt":"2015-03-10T07:00:00","slug":"the-more-times-you-use-the-word-simply-in-your-instructions-the-more-i-suspect-you-dont-know-what-that-word-means","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/oldnewthing\/20150310-00\/?p=44503","title":{"rendered":"The more times you use the word &#034;simply&#034; in your instructions, the more I suspect you don&#039;t know what that word means"},"content":{"rendered":"<p>\nI was helping somebody look up how to enable frobbing for widgets,\nand I found one set of instructions on a blog somewhere.\nTo be honest, this happened long enough ago that I forgot what it\nwas exactly, but here&#8217;s something that captures the general spirit:\n<\/p>\n<blockquote CLASS=\"q\">\n<p>\nFirst, check whether your widget supports frobbing.\nTo do this, simply run this command\n<\/p>\n<pre>\nmagic ppg=q-40 id=voodoo xyzzy:42\n<\/pre>\n<p>\nwhere <code>voodoo<\/code> is the voodoo code for\nyour widget.\nIt will say &#8220;frob supported&#8221; if your widget\nsupports frobbing.\n<\/p>\n<p>\nIf you don&#8217;t know your widget&#8217;s voodoo code,\nyou can get a list of the voodoo codes and\nenchantment numbers\nfor all\nthe widgets connected to your computer by simply typing\n<\/p>\n<pre>\nyoda PHASERS=warp10\n<\/pre>\n<p>\nand then using the voodoo code in the first command\nline above.&sup1;\n<\/p>\n<p>\nOnce you have\nconfirmed that your widget supports frobbing,\nyou can enable it by simply editing the\nwidget configuration file\n<code>abc<\/code>\nand adding <code>frob=\"1\"<\/code>\nto the attributes of the appropriate entry.\n(If there is an existing\n<code>frob=\"0\"<\/code>, then simply change the 0 to a 1.)\n<\/p>\n<p>\nThe changes will take effect at the next reboot.\nTo make them take effect immediately,\nsimply run the command\n<\/p>\n<pre>\nepiskey GANDALF.color=black DRADIS=pikachu\n<\/pre>\n<\/blockquote>\n<p>\nMy reaction was &#8220;Wow, this is really complicated.\nI have no idea how a normal human being is expected\nto know how to do this.&#8221;\nAnd each time the next step in the process was\nrevealed,\nmy bewilderment increased.\n<\/p>\n<p>\nWhat struck me more was that the instructions\nused the word &#8220;simply&#8221; a lot.\nIt became clear that the person writing the article was\nliving in a world different from me.\nTo me, the simple way to accomplish the task\nwould have been if frobbing were enabled\nautomatically if the hardware supported it.\nIf there is some downside\nto frobbing, say, because it makes the widget run\nslower or use more power, then the simple way\nwould have been to check a checkbox somewhere\nsaying\n&#8220;Enable frobbing&#8221;.\n<\/p>\n<p>\nBut this person lived in a world where dropping\nto a command prompt, running a magic command,\nextracting the right voodoo code from the cryptic output,\nrunning a second magic command,\nthen editing a configuration file,\nand then running a <i>third<\/i> magic command\nfor the changes to take effect\nis a perfectly simple operation.\n<\/p>\n<p>\nI have to confess that I am guilty of this as well,\nwhere I dismiss various Win32 concepts as obvious,\nbut my excuse is that my intended audience is\ndevelopers who are already familiar with Win32,\nand for whom these sorts of things <i>should<\/i>\nbe simple and obvious,\nbecause\n<a HREF=\"http:\/\/blogs.msdn.com\/b\/oldnewthing\/archive\/2009\/02\/12\/9411700.aspx\">\nI&#8217;m trying to move past the basic concepts\nand discuss something more advanced<\/a>.\n<\/p>\n<p>\nI do have entries with a non-technical\naudience in mind.\nThose entries are typically tagged\n<a HREF=\"http:\/\/blogs.msdn.com\/oldnewthing\/archive\/tags\/Tips_2F00_Support\/default.aspx\">\nTips\/Support<\/a>\nand usually come out on Tuesdays.\nIn those entries,\nI try to remember to dial things back.\nI suspect I don&#8217;t always succeed.\n<\/p>\n<p>\n&sup1; If\nthere is more than one widget connected to your\ncomputer, then there will be more than one voodoo\ncode.\nThe instructions didn&#8217;t say how to tell which\nvoodoo code corresponds to which widget.\nPerhaps it was so simple it didn&#8217;t need to be explained.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>I was helping somebody look up how to enable frobbing for widgets, and I found one set of instructions on a blog somewhere. To be honest, this happened long enough ago that I forgot what it was exactly, but here&#8217;s something that captures the general spirit: First, check whether your widget supports frobbing. To do [&hellip;]<\/p>\n","protected":false},"author":1069,"featured_media":111744,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[1],"tags":[26],"class_list":["post-44503","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-oldnewthing","tag-other"],"acf":[],"blog_post_summary":"<p>I was helping somebody look up how to enable frobbing for widgets, and I found one set of instructions on a blog somewhere. To be honest, this happened long enough ago that I forgot what it was exactly, but here&#8217;s something that captures the general spirit: First, check whether your widget supports frobbing. To do [&hellip;]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/posts\/44503","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/users\/1069"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/comments?post=44503"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/posts\/44503\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/media\/111744"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/media?parent=44503"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/categories?post=44503"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/tags?post=44503"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}