Defensive Writing

One of the facts of life when you write technical documentation and guidance is that it will get reviewed by other people, resulting in regular changes to the content as you try to follow shifting advice, conflicting feedback, and suggestions that sometimes even make sense. It doesn’t help, of course, if the technology you are…

2

my data are getting littler

It looks like our Big Data is getting smaller. At least that’s the impression I get from the exhaustive investigation carried out by the editor on our current project. Of course, “data” is actually a plural word so perhaps it’s just that each datum is getting smaller. Or maybe there are fewer (not “less”) of…

0

A Book By Any Other Name

So last week saw the sad demise of Bruce Robertson, the managing director of the UK-based Diagram organization that specializes in artwork and design for books and other publications. While I’m sure he’d most like to be remembered by the great work his company has done, the somewhat unfortunate fact is that he’s probably best…

0

The Royal We Is Working On It…

I really am trying to get used to the dumbed-down (sorry, I should say “user-friendly”) move towards simple language and a less technical description of the options and features in modern software UIs. Messages such as “We’re working on it” and “Something went wrong” feel like they would have been programmer’s jokes only a few…

0

Agile Documentation – Tested to Destruction

Agile development is an important technique here at p&p; and throughout much of Microsoft. However, I’m yet to be convinced that it’s a good way of creating user guidance and documentation. It seems to me that the process often gets in the way more than it helps to produce a great final product. I’ve rambled…

2

Soft Drink Cans and a Man Named Norman

So I finally got round to reading Bill Bryson’s book “A Short History of Nearly Everything”. OK, so it’s not quite as entertaining as some of his travel guides, but it is amazingly full of things that make you go “Wow” and “Can you believe it?” I especially liked the bits about soft drink cans…

0

Matrices or Mattresses?

Nobody could accuse me of being posh, and compared to most of the developers I work with here at Microsoft I’m probably not the brightest button in the box. But I did study mathematics in the past, including matrix theory. I just never got to pronounce it right. It all came rushing back to me…

0

Is it a Scenario? Is it a Case Study? No, it’s an Opportunity

A few influential people in our little world of Developer Guidance here are Microsoft have recently been avoiding the word “scenario”. It seems that it’s now so overused, and has so many apocryphal meanings, as to render it useless in terms of determining user’s documentation requirements and for planning the creation of product guidance. As…

1

Hyphenless Decapitalization

According to Readers Digest, there’s a dyslexic agnostic insomniac out there somewhere who lies awake all night pondering on the meaning of dog. Thing is, it really should be “doG”, not “dog”. But it seems that, according to our most recent style guide here at Microsoft, capital letters are fast becoming obsolete, although it’s probably…

2

I Can’t Yell Any More

I suppose it just shows how poor my business skills are. If I ran a hugely successful business directory company called “Yellow Pages” and wanted to extend it to the web, I’d have kept the name and made the web pages yellow. Instead, they changed the name to “Yell”. I guess it works to some…

0