Writing ... or Just Practicing?

Random Disconnected Diatribes of a p&p Documentation Engineer

  • Blog Post: 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....
  • Blog Post: An Upper Case of Indecisive Instruction

    A couple of weeks ago I was ruminating on how somebody in our style guidance team here at Microsoft got a new Swiss army knife as a holiday-time gift, and instead of a tool for removing stones from horse's hooves it has one for removing capital letters and hyphens from documentation. Meanwhile the people...
  • Blog Post: It Configures

    Some weeks ago, I rambled on for a while about making a use case for scenarios . It came about through an experience working on a project where a specific set of features of the software were so complex and unintuitive when you randomly played with them that it seemed almost impossible to provide potential...
  • Blog Post: Agile Government

    I was talking with a colleague the other day about how a pre-agreed plan can morph over time so that the final outcome bears almost no relation to the original specification. I tossed into the conversation my opinion that he should think of it as being like a Government election. The truth changes over...
  • Blog Post: Making a Use Case for Scenarios

    Technical writers, like wot I am, tend to be relatively docile and unflappable creatures. It comes with the territory (and, often, with age). Especially when most of your life is spent trying to document something that the dev team are still building, and particularly so if that dev team is resolutely...
  • Blog Post: Can Writers Dance The Agile?

    It's probably safe to say that only a very limited number of the few people who stroll past my blog each week were fans of the Bonzo Dog Doo Dah Band. Or even, while they might recall their 1968 hit single "I'm the Urban Spaceman" (which, I read somewhere, was produced by Paul McCartney under the pseudonym...
  • Blog Post: Agile Development in the Bricks and Mortar World

    It's a strange experience when you open the curtains in the morning to be faced by men in high visibility jackets and hard hats only a few yards away, and 30 feet above the ground. Mind you, the noise made by the assortment of cranes, diggers, and other plant they use - combined with regular hammering...
  • Blog Post: Measuring Job Satisfaction

    Listening to the radio one day this week, I heard somebody describe golf as being "a series of tragedies obscured by the occasional miracle". It struck me that maybe what I do every day is very similar. If, as a writer, you measured success as a ratio between the number of words you write and the number...
  • Blog Post: Am I Done Yet...?

    I've been trying something new and exciting this week. OK, so it's perhaps not as exciting as bungee jumping or white-water rafting, but it's certainly something I've not tried before. I'm experimenting to see if I can use Team Foundation Server (TFS) to monitor and control the documentation work for...
  • Blog Post: In Search Of The Missing Link

    Every now and then I get to write actual code rather than just documentation. Usually there's either a crowd watching in amazement that I can actually find Visual Studio, never mind knowing some of the magic keywords that make it all work when you press the green arrow button. Or else everyone is cowering...
  • Blog Post: Agile Environmental Management

    I'm not much into wearing daft T-shirts, or T-shirts with logos that proclaim my technical proclivities (such as being a Windows user, or knowing how to configure a DNS server), though one of my favorites is a T-shirt with a big picture of an organ donor card. It carries the slogan "DONER CARD" with...
  • Blog Post: Tragile Documentation

    I just discovered last week that I'm supposed to be able to "move quickly and lightly", be "as sleek and agile as a gymnast", and be "fleet of foot". Either that or I'm supposed to be an X-ray and Gamma ray astronomical satellite belonging to the Italian Space Agency. Not much hope of any of these happening...
  • Blog Post: How p&p Makes Cheese Sandwiches

    OK, so we don't actually make cheese sandwiches here at p&p. Well, as far as I know we don't (but if we did, they'd probably be the best cheese sandwiches in the world...). When I'm over in Redmond I have to stroll across the bridge to Building 4 and buy one from the canteen, though it's worth the...
Page 1 of 1 (13 items)

Browse by Tags