Paying some interest to your docs

With the release of the Ontario and the federal Canadian budgets, debts and interest rates are again in the news. Both budgets continue to run deficits; this is especially frustrating in Ontario, whose government recently commissioned a document (the Drummond report) that recommended major spending cuts; yet another effective user guide that has been promptly ignored.

Interest rates are the lowest they’ve even been in years. This keeps borrowing costs low, but creates another problem: if rates rise even a small amount (as they inevitably will), borrowing costs increase tremendously.

Canada’s debt is currently about $566 billion. Even a tiny .1% rise in interest rates (that’s one-tenth of one percent) would increase borrowing costs a staggering $566 million a year, or over a one and half million dollars per day.

Interest rates are also important on a personal level. For example, if you have a $375,000 mortgage, a 1% rise in rates adds about another $3,750 a year in interest, or over $300 per month. If you’re already treading water and living paycheque to paycheque, this could be enough to push you into bankruptcy, and out of your house – exactly what’s been happening in the United States.

We see then, that the following formula is life-altering:

debt X interest rate = interest payment

Even a small change in rates can greatly increase the interest payment, if the debt is large.

All this got me wondering: What is the interest payment of a document?

To find this out, we need to determine:

  • the debt of a document
  • the interest rate of a document

The debt of a document, like financial debt, represents the total value of the document. This is comprised of the size of the document, including the total number of words, graphics, index entries, cross-references and other information elements.

The interest rate of a document includes:

  • the volatility of the document – the degree to which the document needs to be updated because of changes in the product or thing being document; in other words, how much and how frequently the document must be maintained
  • the importance of the document – a document that is not used or is considered irrelevant or unimportant has little value; the users or the organization that owns the document literally has little interest in it

A document’s interest payment is the amount of effort a technical communicator must exert to ensure that the document is properly maintained. It is the size of the document multiplied by its interest rate.

Larger documents generally have higher interest payments than smaller ones, because greater effort is required to maintain them. However, a large document may have a lower interest payment if its interest rate is sufficiently low, for example:

Large document: 5,000 x 1% = 50
Small document: 3,000 x 2% = 60

The first figure in each equation (the debt or size of the document) is arbitrary and is simply there to indicate relative sizes.

Now, what happens if you fail to make the interest payments? The debt of the document increases as it becomes more outdated and chaotic. It may even reach a point where the owner must declare bankruptcy and create an entirely new document.

Who knew documentation could be so…interesting?


One thought on “Paying some interest to your docs

  1. badgerpendous

    I only recently discovered your blog. Great stuff!

    I've often talked about the “cost” of a document. Much like ongoing interest payments, the true cost of a document isn't paid upon completion of the first release. The interest you mention — importance, volatility — can also include real costs such as localization or printing. And it all adds up over time. Now multiply that by the number of documents you have…

    I always make it clear that just “adding a new document” isn't a simple case of banging out a few pages and maybe sprinkling in some diagrams. There's an expensive commitment to the reader/customer/user that the document they read will be current and helpful.

Comments are closed.