Writing ... or Just Practicing?

Random Disconnected Diatribes of a p&p Documentation Engineer

  • Blog Post: Are Answers On The Menu?

    Reading in the newspaper this week about the technological advances in political campaigning set my mind wondering about whether there is an ethics/success trade-off in most areas of work, as well as in life generally. I don't mean cheating in order to win; it's more about how you balance what you...
  • Blog Post: Semantically Speaking...

    So I've temporarily escaped from Azure to lend a hand with, as Monty Python would say, something completely different. And it's a bit like coming home again, because I'm back with the Enterprise Library team. Some of them even remembered me from last time (though I'm not sure that's a huge advantage...
  • Blog Post: General Cluster's Probably Not Last Stand

    I don't know if General Custer ever made a last stand against the Apache, but I feel like I have. My Apache is, of course, the Hadoop one. Or, to be technically accurate, Microsoft Azure HDInsight. And, going on experience so far, this is unlikely to actually be the last time I do it. After six months...
  • Blog Post: 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...
  • Blog Post: I Can See Patterns In The Cloud

    Well, we finally did it. After many months of redesign, reconsideration, rewrites, and recombination we've let loose on the web our first release of the Cloud Design Patterns guide. The guide is a combination of design patterns that are especially applicable to cloud-hosted applications and services...
  • Blog Post: Gimmie The Code!

    It seems like a question that has an obvious answer: How should you show code listings in guidance documents? I'm not talking about the C#/VB/other language debate, or whether you orient it in landscape mode to avoid breaking long lines. No, I'm talking about the really important topics such as what...
  • 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: Over-egging the Curator's View

    At one time you had to work in a museum to be a curator, but the wonders of information technology mean that now we can all exhibit our technical grasp of complicated topics and elucidate the general population by identifying the optimum resources that help to answer even the most complex of questions...
  • Blog Post: Patternal Conflict

    No, this post isn't about parental difficulties and I didn't spell "paternal" wrong in the title, although I admit it is about problems with relationships. More specifically, the relationship between design patterns and pretty much everything else. And, based on previous experience of dabbling in this...
  • Blog Post: An Insight Into The Future Of Data Analysis?

    It seems like everything is "HD" these days. Your laptop has a "high density" plastic case, your car has a "heavy duty" battery, and your TV has a "high definition" picture. So I guess it's only to be expected that your data analysis tools will be "highly distributed". And at last we're "happily done...
  • Blog Post: Highly Distributed Insights

    Why would you want to use a "Big Data" solution? It's a question that we've been trying to answer in the first chapter of our forthcoming p&p guide to Windows Azure HDInsight. For a long while, everything we found on the web and in the original HDInsight docs on the website talked just about the...
  • Blog Post: Big Data, Big Guidance Problem

    You'd think that, after all the years I've been writing guidance for Microsoft technologies and tools, I'd have at least grasped how to organize the structure of a guide ready to start pouring content into it. But, just as we're getting into our stride on the Windows Azure HDInsight project here at p&p...
  • Blog Post: 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...
  • Blog Post: What Color Is Your Field?

    So, at last, we're done. After fighting with multiple new versions of the Windows Azure SDK, updated features in the management portal, changes to the functionality of services, and the regular changes to the names of various parts of Windows Azure, we've shipped the third editions of two of our Windows...
  • Blog Post: A Prolonged Burst of Frenetic Procrastination

    Following a discussion last week about how the most successful national clubs and societies have evolved, I was amused by a response from someone who professed to setting up the National Procrastination Society. He reckons that this is the most successful society ever because none of the members has...
  • Blog Post: You Don't Need Fourpence to Make the Internet Disappear

    So I just found out this week why Automobile Association patrolmen didn't need to carry four one-penny coins around at all times. According to an item on the program "QI", in the early days of Britain's acquisition of a nuclear attack capability they worried how they would contact the Prime Minister...
  • Blog Post: A Relentless Paper Chase (aka Painting Windows Azure)

    Here in Britain we always used to refer to a job that was never-ending as "like painting the Forth Bridge." It came about because the people who paint the huge and magnificent railway bridge over the Firth of Forth in Scotland reportedly start at one end and it takes so long that, when they reach the...
  • 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: Web Sites or Cloud Services?

    The latest update to the range of Windows Azure services includes a nifty feature called Web Sites that provides a really great way to deploy your own websites to the cloud. It's quick and easy, you can progressively update the site by uploading individual files, and it's cheap. In fact at the moment...
  • Blog Post: 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...
  • Blog Post: Hands-Off Labs

    It seems to be a general rule now here at p&p that every guide we produce must have an associated set of practical examples so that users can get their hands (and keyboards) dirty playing with the technologies. It's almost like we're worried that our readers won’t believe the stuff actually...
  • Blog Post: It Feels Like I've Been Snookered

    Probably the most memorable comment from a snooker commentator was Ted Lowe during a Pot Black match in the late 1960s. Acknowledging the fact that in those days many viewers didn't have a color television, he helpfully noted "for those of you watching in black and white, the pink ball is next to the...
  • Blog Post: Hybrigation Complete, Feedback Required...

    So at last we've finished the Windows Azure hybrid applications guide , and it's out there ready for anyone interested in integrating cloud-hosted applications with on-premises services and partner applications. OK, so it's taken a little longer than originally planned but it is more comprehensive than...
  • Blog Post: An Enduring Documentational Experience

    Unless you write books or guidance for long-lived technologies, such as assembly code programming or software design patterns, the products of your IT documentational effort tend to have a somewhat limited shelf life. There's always a new version of ASP.NET, Linux, J2EE, or C# just around the corner...
  • Blog Post: The (Non-political) Third Way

    One of the major advances in politics in recent years has been the evolution of “The Third Way”. You know the kind of thing: Given a choice between two approaches to a problem, neither of which are politically palatable, politicians invent a “third way” that relieves them of the...
Page 1 of 3 (62 items) 123

Browse by Tags