\u201cThere’s nothing in the middle of the road but yellow stripes and dead armadillos.<\/em>\u201d<\/p>\n<\/blockquote>\n\n\n\n When we were building the early versions of PowerShell (back when it was Monad), we had a massive fight over a single word. It seemed trivial to everyone else, but I knew it was a hill worth dying on. It was the fight over the word Cmdlet.<\/p>\n\n\n\n The disagreement wasn’t a matter of wordsmithing; it was a foundational issue about establishing the cognitive contours of the product – how people would think, learn, find things, and form a community. It was an issue of soul.<\/p>\n\n\n\n\n\n\n\n In the initial prototype of Monad, I referred to what are now called cmdlets as Function Units,<\/strong> which I then shortened to FUs<\/strong>. This abbreviation reflected the Unix smart-ass culture I was embracing at the time. Plus I was developing this in a hostile environment, and my sense of diplomacy was not yet fully operational. \ud83d\ude42<\/p>\n\n\n\n So, you\u2019d have FUs for processes and FUs for services. We had lots of fun with that! But you can see why we had to change that. Even I knew shipping a Windows Feature full of FUs wasn\u2019t going to fly in Redmond.<\/p>\n\n\n\n I replaced FUs with Cmdlets<\/strong>\u2014short for command-lets. They were small, focused commands. It was descriptive, precise, and technically accurate.<\/p>\n\n\n\n But the documentation team hated it.<\/p>\n\n\n\n They looked at their style guides and their consistency metrics, and they said, \u201cJeffrey, we need to change this to ‘Command.’ We have to align with the rest of Windows. Users know what a ‘Command’ is. ‘Cmdlet’ is jargon.\u201d<\/em><\/p>\n\n\n\n Now, understand the organizational gravity here. The documentation team\u2019s job is to reduce friction by standardizing language. They wanted to smooth off the rough edges. That is their mission. But I realized they were focusing on the wrong kind of friction.<\/p>\n\n\n\n They were arguing that Command was easier to read. I argued that Command was impossible to find<\/em>.<\/p>\n\n\n\n Command is a generic term. It means everything, so it means nothing. <\/p>\n\n\n\n I didn\u2019t win this argument with philosophy; I won it with data. I ran a simple test, and I asked the docs team to look at the results.<\/p>\n\n\n\n I went to a search engine and queried the word Command.<\/p>\n\n\n\n The result? Hundreds of millions of hits. Everything from DOS commands to military commands to command and control. It was an ocean of noise.<\/p>\n\n\n\n Then I queried Cmdlet.<\/p>\n\n\n\n The result? A few thousand hits. And every single one of them was relevant to us.<\/p>\n\n\n\n That was the Aha! moment. I realized that by using a unique term, I wasn\u2019t confusing users; I was giving them a flashlight in a dark room. I was guaranteeing that if they searched for Cmdlet, they would find us<\/em>. They wouldn\u2019t find an OS\/360 manual, a VMS DCL thread, or a DOS newsgroup from 1985.<\/p>\n\n\n\n There is a fundamental trade-off in design that people often ignore. You have to choose between Conformity<\/strong> and Distinctiveness<\/strong>.<\/p>\n\n\n\n But\u2014and this is the key\u2014that friction was an investment. Once you learned the word, you had a high-fidelity channel for communication.<\/p>\n\n\n\n In my view, getting comfortable with being uncomfortable is the price of admission for innovation. We accepted the initial discomfort of a weird name to buy ourselves a lifetime of precise search results.<\/p>\n\n\n\n We often half-ass our naming conventions because we think of naming as marketing or docs. That is a disaster. Naming is a functional requirement. It defines the ontology of your product. It teaches people how to think. It is conceptual engineering.<\/p>\n\n\n\n In a world driven by search engines (and now AI), the uniqueness of your terminology dictates the success of your support ecosystem.<\/p>\n\n\n\n If I use a common word like Script or Command, I am throwing my user’s problem into the ocean. You might as well ship a rabbit\u2019s foot with your product – your customer is going to need all the luck they can get finding an answer.<\/p>\n\n\n\n By coining Cmdlet, I created a specific semantic bucket. When the community wrote a blog post, or a script, or a help file, they put it in that bucket. Our language defined our community and made it easy for us to find one another and communicate with each other.<\/p>\n\n\n\n This is the 2 AM Principle in action. When an admin is paged at 2 AM because a server is down, they don’t care about the corporate style guide. They care about finding the fix right now<\/em>. If they Google \u201cExchange Command fails<\/strong>\u201d, they get garbage. If they Google \u201cExchange Cmdlet fails<\/strong>\u201d, they get the solution.<\/p>\n\n\n\n Naming is a discoverability feature. If you can’t Google the answer, the feature is broken.<\/p>\n\n\n\n Here is the hard truth about leadership: Sometimes you need to go with judgement and sometimes you need to go with data.<\/strong><\/p>\n\n\n\n The documentation team had a Style Guide. That is a collection of expert judgement calls.<\/p>\n\n\n\n I had search result counts. That is data.<\/p>\n\n\n\n When you are in a deadlock about readability or standards, bringing concrete numbers to the table\u2014even crude ones like search hit counts\u2014is the only way to cut through the bureaucracy.<\/p>\n\n\n\n But ultimately, you cannot A\/B test every strategic decision. You have to use judgment to make a bet.<\/p>\n\n\n\n I made the bet that the friction of learning a new word was outweighed by the benefit of precise search results.<\/p>\n\n\n\n I was betting on the long game. I was betting that our users were smart enough to learn a new word if it actually helped them solve their problems.<\/p>\n\n\n\n Today, PowerShell users benefit from a relatively noise-free search environment because of that decision. <\/p>\n\n\n\n When you are building something new, ask yourself: Are you trying to blend in, or are you trying to be found?<\/p>\n\n\n\n Don\u2019t be weird for the sake of being weird. But \u2026 <\/p>\n\n\n\n If being weird is a path to success – then have the courage to be weird!<\/strong><\/p>\n<\/blockquote>\n\n\n\n I\u2019ve spent a lot of time, and acquired a lot of scar tissue, in this industry, and if there is one thing I\u2019ve learned, it\u2019s that most people are terrified of looking different. People hug the center of the road … Continue reading The Battle for a Word<\/strong><\/h1>\n\n\n\n
The Search Query Test: Measuring the Noise<\/strong><\/h1>\n\n\n\n
Lesson 1: Conformity vs. Distinctiveness<\/strong><\/h1>\n\n\n\n
\n
Lesson 2: Naming is Conceptual Engineering<\/strong><\/h1>\n\n\n\n
Think of it like a Semantic Bucket.<\/h1>\n\n\n\n
Lesson 3: Judgment and The Bet<\/strong><\/h1>\n\n\n\n
Conclusion<\/strong><\/h1>\n\n\n\n
\n
![\"\"](\"https:\/\/www.jsnover.com\/blog\/wp-content\/uploads\/2025\/12\/CmdletNaming-scaled.png\")
<\/a><\/figure>\n","protected":false},"excerpt":{"rendered":"