Why Microsoft Developers Need a Style Guide 262
snydeq writes "What your interface communicates to users can be just as important as what your software does, writes Fatal Exception's Neil McAllister in discussing the latest edition of the 'Microsoft Manual of Style', a style guide aimed at designers and developers who create Microsoft software, as well as those who write about it. 'The gist of much of Microsoft's advice is that a user's relationship with computer software is a unique one, and it's important to craft the language of software UIs accordingly,' McAllister writes. 'Occasionally, Microsoft's recommendations verge on the absurd. For example, you might not think it necessary to admonish developers to "not use slang that may be considered profane or derogatory, such as 'pimp' or 'bitch,'" but apparently it is.'"
Obviously it is... (Score:4, Funny)
You silly open source GIMP developers...
Nobody is happy (Score:0, Funny)
The only intuitive interface is the anus, and even people like goatse mess it up.
When loading a kernel module... (Score:5, Funny)
Cancel, or "pimp this bitch"
They are bad at naming things. (Score:5, Funny)
Take the 'Malicious Software Removal Tool' for one example. Sounds to me like a malicious program that goes and removes software from your computer. They should have called it the 'Tool for Removing Malicious Software'. I look at such ambiguity with a laugh. I recently had a dialogue box on my computer saying something along the lines of "Problem Reporting _____". (I forget the exact text.) Does that mean that the system is reporting a problem, or having a problem reporting? Considering that most users of the software are not experts, they should try harder to make things less confusing.
You may scoff, but style is everything (Score:5, Funny)
Choose the single leg double-hand overarm for distance.
Or, if you want maximum impact, and hence noise when the chair lands, go for height: a full seat grab upper thrust is your best option.
Then there's the full intimidator, often accompanied with shrieks alluding to colorfully burying someone whilst holding it by two legs high above your head - this move requires two full laps of the office before deployment.
Re:Rude words (Score:5, Funny)
What if you are actually writing software for a pimp or dog breeding?
Re:Rude words (Score:5, Funny)
Re:I have an idea for the style guide (Score:5, Funny)
I don't know, I found the chapter on EnterpriseInterfaceThunkClassEnterpriseGeneratorCOMParameterInterfaceThunk32 COM_Enterprise_Enterprize_ENTERPRISE very illuminating.
Re:They are bad at naming things. (Score:2, Funny)
>Take the 'Malicious Software Removal Tool' for one example. Sounds to me like a malicious program that goes and removes software from your computer
Thank you for your bad ass-insight [xkcd.com].
Re:They are bad at naming things. (Score:5, Funny)
Design patterns: alternate names (Score:5, Funny)
You may be familiar with design patterns [wikipedia.org]. Those in the know sometimes give them nonstandard names, such as:
There is a good reason for this... (Score:5, Funny)
...admonish developers to "not use slang that may be considered profane or derogatory, such as 'pimp' or 'bitch,'" but apparently it is.'"
Microsoft does not want their true relationship with their customers to become widely known.
Re:They are bad at naming things. (Score:5, Funny)
Take the 'Malicious Software Removal Tool' for one example. Sounds to me like a malicious program that goes and removes software from your computer.
The name accurately describes what the software does and how. Your explanation that it is a malicious tool that removes software is correct. Your mistake is to assume it is a tool to remove malicious software.
Re:When loading a kernel module... (Score:5, Funny)
Re:They are bad at naming things. (Score:5, Funny)
They should have called it the 'Tool for Removing Malicious Software'
I'm sorry, you'll have to take up your grievance with Richard Stallman; Apparently GPLv3 is the only license allowed for derivatives acronyms such as TRMS.
Re:Master/slave (Score:4, Funny)
Similarly, the relationship between USB peripherals could be described as "master/slave," but these terms could also be considered offensive. (The "Microsoft Manual of Style" says such language is prohibited in "at least one U.S. municipality.")
Damn! I just finished changing all master/slave references to pimp/bitch. And now they tell me that this won't do either?
How about top/bottom?
Domme/sub?
Ob. scenario: (Score:3, Funny)
Clippy: "It looks like you're trying to pimp your presentation. Would you like some help with this?"
Options: "Yes. Show me how to pimp my document!"
"No, fuck off you annoying little shit!"
"If I have to turn you off in the options again I'm gonna bitchslap my laptop!"
Re:Bad title (Score:5, Funny)
Re:Nobody is happy (Score:5, Funny)
is that an API does not break "unwritten" conventions like always returning true even when the operation was unsuccessful
Most POSIX APIs return true on error and false on failure. The idea is that this lets you write if (something()) { error_handler(); }. I've no idea why they thought this made more sense than if (!something()), but judging by the rest of UNIX I suspect that they had to type their code in morse with one hand while fighting a tiger with the other, so every character saved could mean the difference between life and death...