November 21st, 2023

Microspeak revisited: Line of sight

Some time ago, I covered the Microspeak term line of sight, meaning “having a plan for” or “being on track to accomplish” something.

I found a number of usages of the jargon term “line of sight” in the Microsoft Azure documentation. Unfortunately, none of them appear to provide a definition.

  • “Hybrid Azure AD joined devices require network line of sight to your domain controllers periodically.”
  • “Your client must have line of sight to your AD DS.”
  • “Non-domain-joined VMs or VMs that are joined to a different AD domain than the storage account can access Azure file shares if they have line-of-sight to the domain controllers and provide explicit credentials.”

When I asked Bing Chat what Azure “line of sight” meant, it told me,

In Azure, line-of-sight is used to refer to the ability of non-domain-joined VMs or VMs that are joined to a different AD domain than the storage account to access Azure file shares if they have line-of-sight to the domain controllers and provide explicit credentials.

It appears to have ingested the last reference and turned it into a circular definition: A VM has “line-of-sight” if it has line-of-sight to the domain controllers.

From what I can gather from context, “network line of sight” just means “network connectivity.”

The fact that the term is widely used in the documentation without ever being defined suggests that this was an internal jargon term that became so well established that when the team wrote their documentation, they used it freely on the assumption that everybody knows what it means. It might be true that everybody in the bubble of the Azure team knows what it means, but these documents were written for an outside audience, not for other Azure team members. The documentation was written with Azure-colored glasses.¹

Breaking news: I stumbled across another page that appears to give a definition for “line of sight”.

Having direct line of sight connectivity means that the client can connect directly to the session host without being blocked by firewalls.

Notice that the phrase is not hyphenated here. I don’t know whether the hyphens are significant.

But given this new information, I think a better definition of “line of sight” is “unimpeded network connectivity.”

¹ Failing to write for your audience is an error I often see in engineering documents. Documents intended for a wide audience are written with the assumption that the reader is already familiar with the internal workings of the component under discussion. One way this manifests itself is in the use of imprecise terminology: The imprecision may be a handy shortcut for team members, who can mentally bridge the gap between what was said and what was meant. But people reading the document do not have this level of experience and context, and the casually imprecise phrasing just creates confusion. Another phenomenon is the substitution of an alternate term that the team uses as a synonym for the official term, without ever defining the alternate term. For example, a graphics team might use the terms “flip” and “swap” interchangeably, but only the term “flip” is in the glossary.

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.

5 comments

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

  • Mark Powell

    Coming from a radio communications background, I don’t think I realized that line of sight wasn’t a commonly used term.

    For us, it’s a clear, unobstructed, direct path from source to destination. As opposed to skip, groundwave, or NVIS communications- all of which are techniques to communicate with someone either over the horizon or behind a mountain.

    • Raymond ChenMicrosoft employee Author

      I understand the term “line of sight” in the visual sense, but it wasn’t clear how that applies to computer networks. Do the two computers have to be connected directly to each other by a taut network cable?

    • Brian Boorman

      We call that BLOS. Often used in reference to HF radio or SATCOM.

  • Yuri Khan

    ¹ Do glasses of any color affect the line of sight?

  • Erik Fjeldstrom

    Good to know that people in the dev team like to play D&D!