September 5th, 2023

When documentation cautions that something may not happen, that suggests that it normally does happen

TL;DR: If the troubleshooter documentation helps you fix a problem when X doesn’t occur, then this suggests that X normally occurs.

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.

In the Troubleshooting documentation for the internal tool, it says,

In some cases, the tool may fail the operation without prompting you for two factor authentication. If that is the case, then…

If you read between the lines, the documentation is suggesting that under normal conditions, the tool prompt for two factor authentication. It doesn’t come right out and say this, but given that it’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.

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.

Author

Raymond has been involved in the evolution of Windows for more than 30 years. In 2003, he began a Web site known as The Old New Thing which has grown in popularity far beyond his wildest imagination, a development which still gives him the heebie-jeebies. The Web site spawned a book, coincidentally also titled The Old New Thing (Addison Wesley 2007). He occasionally appears on the Windows Dev Docs Twitter account to tell stories which convey no useful information.

2 comments

Discussion is closed. Login to edit/delete existing comments.

  • Ian Horwill

    The exception that proves the rule.

  • Markus Schaber

    The authentication form may also linger in a browser tab somewhere in your open browser windows. Some auth flows open a browser window/tab, especially OAuth based ones.