{"id":108718,"date":"2023-09-05T07:00:00","date_gmt":"2023-09-05T14:00:00","guid":{"rendered":"https:\/\/devblogs.microsoft.com\/oldnewthing\/?p=108718"},"modified":"2023-09-04T16:56:19","modified_gmt":"2023-09-04T23:56:19","slug":"20230905-00","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/oldnewthing\/20230905-00\/?p=108718","title":{"rendered":"When documentation cautions that something may not happen, that suggests that it normally does happen"},"content":{"rendered":"<p>TL;DR: If the troubleshooter documentation helps you fix a problem when X doesn&#8217;t occur, then this suggests that X normally occurs.<\/p>\n<p>Someone reported on a peer support distribution list that running a particular internal tool appeared to hang, and they were hoping someone could help troubleshoot why.<\/p>\n<p>In the Troubleshooting documentation for the internal tool, it says,<\/p>\n<blockquote class=\"q\"><p>In some cases, the tool may fail the operation without prompting you for two factor authentication. If that is the case, then&#8230;<\/p><\/blockquote>\n<p>If you read between the lines, the documentation is suggesting that under normal conditions, the tool prompt for two factor authentication. It doesn&#8217;t come right out and say this, but given that it&#8217;s giving you a workaround if the two factor authentication prompt fails to appear, that means that people are expecting the prompt and not getting it.<\/p>\n<p>My suggestion was to look around for a two factor authentication prompt, possibly covered by another window. My guess is that the tool is waiting to complete an authentication flow.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Reading between the lines.<\/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":[104],"class_list":["post-108718","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-oldnewthing","tag-tipssupport"],"acf":[],"blog_post_summary":"<p>Reading between the lines.<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/posts\/108718","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=108718"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/posts\/108718\/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=108718"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/categories?post=108718"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/tags?post=108718"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}