Skip to main content

A technique for advocating change

Communication is a key part of every software analyst’s work.  Some of the time we write formal documents such as design specifications or descriptions of coding standards. We write operational documentation for users and for support staff.  We write blog posts that describe our work, and we write comments in our code and e-mails to our colleagues.   We present our ideas in meetings, in formal presentations and informal discussions.

So it is important to pay attention to these skills, so that we can communicate more effectively.  There are training courses to help us with the basics.  As with any other skill, we can learn through reading about specific techniques, looking at other people’s work, and reflecting on our own work. (In his book Patterns of Software, Richard Gabriel advocates that reading poetry is a good way to improve our writing skills.  His arguments, on page 149, are worth reading for the virtues they espouse whether you read poetry or not).

In this post, I describe one way to structure a particular form of communication: that of making something happen (or stop happening).  In writing, this is most likely to be an e-mail; you could also be making the point face-to-face in a meeting.  The structure works in either setting.  The aim is to make sure that everyone understands the situation and your proposal for action.  Each person in the meeting or reading the e-mail should be clear about what you are asking them to do.

The structure has four parts: context, advocacy, illustration and inquiry.

Framing: Describe the situation.  Why are you sending the e-mail or calling the meeting?  What is the problem to be solved? 

Advocacy: What strategy do you propose to address the situation? 

Illustration: What would your strategy mean for everyone involved? There may be several ways to implement your strategy; what is your view as to how it should be done?

Inquiry:  Ask the others whether they share your perceptions, agree with your strategy, concur with the proposed implementation and understand what they have to do.

The inquiry step may reveal disagreement with any of the preceding three steps.  If people perceive the situation in a different way, they will likely advocate different strategies, so it is important to reach agreement on the context first.  Then, people may disagree on the strategy; other people may advocate a different approach.  This structure lets you work through the discussion step by step. 

It is important that all your colleagues understand what you are asking of them.  If you are sending your proposal as an e-mail message, read it through before sending and ask yourself whether each person on the To: field will understand what you are wanting from them.  It’s surprising how easy it is to write a message that contains information but does not clarify what you are expecting from the recipient.  (I know I make this mistake myself).

This technique comes from the book Action Inquiry by Bill Torbert.  I try to use this technique myself and I find it useful.  If you have any comments, please let me know.


Popular posts from this blog

A new EA Repository

One of my goals since starting this job two years ago has always been to create a repository for architecture documents.  The idea is to have a central store where people can find information about the University's applications, data sources, business processes, and other architectural information.  This store will make it easier for us to explain our plans, to show the current state of the University's information systems, and to explain what Enterprise Architecture is all about.

It's taken a long time to reach this goal, mainly because we're often had more pressing and immediate work to be done.  The creation of a repository is one of those tasks that is very important but never quite urgent.  So I'm now very happy to say that we are in the process of deploying a repository and modelling tool.

This is the culmination of a careful process to select the most appropriate tool for our needs.  We began by organising several workshops to gather requirements from a rang…

A brief summary of our major initiatives

I notice that in 2016 I wrote 34 posts on this blog.  This is only my fifth post in 2017 and we're already three-quarters of the way through the year.  Either I've suddenly got lazier, or else I've had less time to spend writing here.  As I'm not inclined to think of myself as especially lazy, I'm plumping for the latter explanation.

There really is a lot going on.  The University has several major initiatives under way, many of which need input from the Enterprise Architecture section.

The Service Excellence programme is overhauling (the buzzword is "transforming") our administrative processes for HR, Finance, and Student Administration.  Linked to this is a programme to procure an integrated ERP system to replace the adminstrative IT systems. 

Enabling Digital Transformation is a programme to put the middleware and architecture in place so that we can make our processes "digital first".  We're implementing an API framework, a notification…