{"id":43213,"date":"2015-01-06T07:00:00","date_gmt":"2015-01-06T22:00:00","guid":{"rendered":"https:\/\/blogs.msdn.microsoft.com\/oldnewthing\/2015\/01\/06\/no-good-deed-goes-unpunished-marking-a-document-as-obsolete\/"},"modified":"2019-03-13T12:11:48","modified_gmt":"2019-03-13T19:11:48","slug":"20150106-00","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/oldnewthing\/20150106-00\/?p=43213","title":{"rendered":"No good deed goes unpunished: Marking a document as obsolete"},"content":{"rendered":"<p>I was contacted by a customer support liaison who was hoping that I could help them understand Feature&nbsp;X. <\/p>\n<blockquote CLASS=\"q\"><p>I saw your name on a &#8220;Feature&nbsp;X technical specification&#8221; document in the Windows specification repository, and I was hoping you could answer a few questions for me, or redirect me to somebody who can. <\/p><\/blockquote>\n<p>I was puzzled why this person saw my name on the &#8220;Feature&nbsp;X technical specification&#8221; document in the Windows specification repository, because I was not the author of that specification. I went to the specification repository, opened the document in question, and nope, my name appears nowhere in it. <\/p>\n<p>I asked, &#8220;What gave you the impression that I had anything to do with Feature&nbsp;X? XYZ can help you with your questions; he&#8217;s the one listed as the author of the document.&#8221; <\/p>\n<p>The response was, &#8220;Oh, I&#8217;m sorry. I didn&#8217;t actually read the specification. I merely did a search through the entire repository for <i>Feature&nbsp;X<\/i>, and the &#8220;Feature&nbsp;X technical specification&#8221; is the one that showed up as most recently updated by you. In the past, this technique has been pretty good at finding someone who can help with a feature. Sorry about that.&#8221; <\/p>\n<p>I went back and took another look at the document, and then I remembered why I updated it: My duties at the time included reviewing all documents that met certain criteria, such as this particular document. I had some feedback about the document for the author, who told me, &#8220;Oh, that&#8217;s an obsolete version of the document, but it&#8217;s retained for historical purposes. The current one is over there.&#8221; To save the next person some time, I edited the obsolete document by inserting in big letters at the top, &#8220;TECHNICAL DOCUMENTATION FOR THIS FEATURE HAS MOVED TO <font COLOR=\"blue\">&#x27e8;new location&#x27e9;<\/font>. THIS DOCUMENT IS OBSOLETE.&#8221; I could&#8217;ve asked the author to do this, but I had the document open already, so I figured I&#8217;d save a few steps (ask author to update document, wait for reply, reopen document to verify that edit occurred) and just do it myself. <\/p>\n<p>Boom, no good deed goes unpunished. My update was made long after the real technical specification was completed. As a result, of all the documents on Feature&nbsp;X, not only is it the obsolete one that shows up as most recently updated, but I am the one listed as the person who made that most recent update. <\/p>\n<p>Next time, I&#8217;ll try to remember to do things the long way, even though it is big hassle for everybody. <\/p>\n<p>&#8220;Please update the document to indicate that it is obsolete and redirect the reader to the current document.&#8221; <\/p>\n<p><i>&mdash; Could you do that? You&#8217;ve already got the document open.<\/i> <\/p>\n<p>&#8220;No, I used to do that, but it came back and bit me, because I become the person to edit the document last, and then everybody comes to me with questions about the document instead of you.&#8221; <\/p>\n<p><i>&mdash; You do realize that in the time you tried to convince me     to do it, you could&#8217;ve just done it.<\/i> <\/p>\n<p><b>Follow-up<\/b>: I tried it, and sometimes the response was &#8220;I&#8217;m really busy now, I&#8217;ll get around to it in a few weeks.&#8221; Now I have to create a reminder task in two weeks to follow up. More hassle for everybody. <\/p>\n<p>I think the next time this happens, I&#8217;ll write back, &#8220;I&#8217;m coming over to your office. I&#8217;ll make the one-line edit <i>on your computer<\/i> so that your name is the one attached to the edit.&#8221; <\/p>\n","protected":false},"excerpt":{"rendered":"<p>Stop looking at me.<\/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-43213","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-oldnewthing","tag-other"],"acf":[],"blog_post_summary":"<p>Stop looking at me.<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/posts\/43213","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=43213"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/posts\/43213\/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=43213"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/categories?post=43213"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/tags?post=43213"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}