Tech Word

  • Subscribe to our RSS feed.
  • Twitter
  • StumbleUpon
  • Reddit
  • Facebook
  • Digg

Wednesday, 22 October 2008

Political Interchange

Posted on 07:33 by Unknown
Politicians are the masters of interchangeability. They often do and say the same things. This comes in handy whenever they have to develop policy - they simply lift it from another party, giving new meaning to the term "single-sourcing".

Where politicians especially excel is in their use of political slogans. You can take almost any slogan or expression from one party and reuse it in another. Here's a few examples, culled from the websites of various political parties, and from my vivid imagination:

Strong leadership
Tough times demand leadership to pull us together
Leadership certainty for Canada's economy


A vision for the future
Clear direction for a brighter future

Working for your future
Helping families get ahead
Working for your family
Expanding opportunities for families

It’s time for a Prime Minister who’ll respect your vote
Giving everyone a fair shot
Making a difference

We’ll always be on your side
Looking out for your interests
For a richer, fairer Canada

Putting families first
Putting farmers first
Putting workers first

We'll invest in your future
Let's unite for the future
Looking out for your future

We're a big tent party
Getting the job done right
Taking action on the economy

Protecting your job
Protecting your future
Protecting natural resources

A clear choice
A new choice
A strong choice
A choice of hope and optimism
Facing a critical choice


Text like this is reused, quite literally, across different (party) platforms. When developing documentation that will be reused, keep the principle of interchangeability in mind. The following example illustrates this:

You are documenting a set of installation guides for various products and want to reuse text where possible. One of the steps common to all products is:

From the installation CD, run Setup.exe.

The problem is that only some of the products are installed from CDs, while others are downloaded. If you want to reuse this step, you'd need to reword it to be fully interchangeable.

You could say:
From the installation package, run Setup.exe.

Or better still: Run Setup.exe.

The last choice is the simplest. It assumes the user knows where to find the setup file. If they don't, they probably shouldn't be installing the program!

Writers have a saying: "write what you know." Technical writers need to "write what they know could be reused anywhere."
Email ThisBlogThis!Share to XShare to Facebook
Posted in politics | No comments
Newer Post Older Post Home

0 comments:

Post a Comment

Subscribe to: Post Comments (Atom)

Popular Posts

  • Six Things That Should Be Single Sourced
    Single-sourcing, as we all know, is the art and science of using a single repository of information to produce multiple outputs. Typical ex...
  • Interviewing and Dating: A Single Source Solution
    Last month, people celebrated "Valentine's Day", a day to celebrate romance and love, a day to be extra-nice to your partner, ...
  • The Power of Words
    There's nothing like an election to illustrate how powerful words are. Politicians, pundits, and the media use words to advance their ca...
  • The Governing Dynamics of Documentation
    Game theory is a specialized field of mathematics that analyzes choices and results in strategic situations, or games , as the players try t...
  • Why info systems fail
    If you only have time to read one news article today, read this one from the Financial Post. Don't leave IT to the techies - Three probl...
  • How to update a document - NOT!
    Canadian International Co-operation Minister Bev Oda needs to work on her document management skills. She hand wrote the word 'NOT'...
  • Publishing for Pollard
    Most of you probably have never heard of Jonathan Pollard, the American who has been languishing in prison since November 21, 1985, almost 2...
  • The Dynamic Blogger
    Some of you may have noticed the new look of this blog. It's a new Blogger feature called dynamic views . You can now choose how this bl...
  • Dude, where's my document?
    Try this experiment: Think of a printed guide you worked on. Find the source document from your current location. Make a minor change to the...
  • Security breach!
    It's always entertaining to read about non-lethal lapses in security at a major event. Remember the debacle at the 2010 Winter Olympics?...

Categories

  • art
  • autism
  • bad communication
  • business
  • career
  • cloud computing
  • computers
  • creativity
  • entertainment
  • finance
  • food
  • Google
  • history
  • interviewing
  • math
  • media
  • medicine
  • misc.
  • music
  • nature
  • news
  • philosophy
  • politics
  • quantum theory
  • religion
  • resume
  • resumes
  • science
  • security
  • simplicity
  • sport
  • technology
  • usability

Blog Archive

  • ►  2012 (9)
    • ►  September (1)
    • ►  August (1)
    • ►  July (1)
    • ►  April (2)
    • ►  March (2)
    • ►  February (2)
  • ►  2011 (36)
    • ►  December (2)
    • ►  November (2)
    • ►  October (6)
    • ►  September (2)
    • ►  August (4)
    • ►  July (5)
    • ►  June (3)
    • ►  May (6)
    • ►  April (2)
    • ►  February (3)
    • ►  January (1)
  • ►  2010 (47)
    • ►  December (3)
    • ►  November (6)
    • ►  October (4)
    • ►  September (2)
    • ►  August (1)
    • ►  July (2)
    • ►  June (2)
    • ►  May (3)
    • ►  April (5)
    • ►  March (11)
    • ►  February (7)
    • ►  January (1)
  • ►  2009 (36)
    • ►  December (11)
    • ►  November (5)
    • ►  October (4)
    • ►  September (2)
    • ►  August (2)
    • ►  July (3)
    • ►  May (1)
    • ►  April (3)
    • ►  March (2)
    • ►  January (3)
  • ▼  2008 (24)
    • ►  December (9)
    • ►  November (1)
    • ▼  October (7)
      • The Colour of Notes
      • Political Interchange
      • Interviewing for the Job and On The Job - Part III
      • Interviewing for the Job and On The Job - Part II
      • The Green Machine
      • Taking Stock of Stocks and Docs
      • Interviewing for the Job and On The Job - Part I
    • ►  July (1)
    • ►  June (1)
    • ►  May (1)
    • ►  April (1)
    • ►  March (1)
    • ►  February (1)
    • ►  January (1)
  • ►  2007 (10)
    • ►  December (1)
    • ►  November (2)
    • ►  October (4)
    • ►  August (1)
    • ►  March (1)
    • ►  January (1)
  • ►  2006 (4)
    • ►  September (1)
    • ►  June (1)
    • ►  April (1)
    • ►  February (1)
  • ►  2005 (10)
    • ►  December (1)
    • ►  November (1)
    • ►  October (1)
    • ►  September (1)
    • ►  June (1)
    • ►  May (1)
    • ►  April (1)
    • ►  March (1)
    • ►  February (1)
    • ►  January (1)
  • ►  2004 (9)
    • ►  December (1)
    • ►  November (1)
    • ►  September (1)
    • ►  June (1)
    • ►  May (1)
    • ►  April (1)
    • ►  March (1)
    • ►  February (1)
    • ►  January (1)
  • ►  2003 (9)
    • ►  December (1)
    • ►  November (1)
    • ►  September (1)
    • ►  June (1)
    • ►  May (1)
    • ►  March (1)
    • ►  February (1)
    • ►  January (2)
  • ►  2002 (3)
    • ►  December (1)
    • ►  November (1)
    • ►  October (1)
Powered by Blogger.

About Me

Unknown
View my complete profile