Mr Creosote, the ultimate in gluttony, from Monty Python.

Intranet content review, cull and control requires drastic solutions. When intranets are piggy eaters, their health problems can only get worse. The eternal problem of intranet obesity is now under discussion on the contentstrategy Google Group. Here’s the question, from Richard English in Toronto:

What if the CMS didn’t have a content expiry process, what if there
was some other method / process that got content reviewed. What would
that look like? I’m looking for off the wall crazy ideas.

Good call, Richard, because the good old faithful solutions (like eat less and exercise) fail again and again. Two off-the-wall crazy ideas follow, as requested.

Dave Couston says:

Semi-off-the-wall: what about setting up some kind of mechanical turk-like process where anyone or a specific subset of people within the organization can use a simple interface to pick up a piece of content from the stack of items that need periodic reviewing, and review it for freshness according to some simple instructions? In return maybe they’d receive some sort of fractional credit that would be worthwhile to them within the org – credit towards an extra day off, something like that? I guess it would only work if there’s little expertise required to determine whether the content needs sunsetting or not, or if the pool of people acting as reviewers had that expertise.

Matt Moore of Innotecture offered a stomach-stapling solution with the following, though he was ‘not necessarily recommending’ any of the ideas:

  • Every 12 months delete everything. Unless someone actively nominates an item to be kept. And some else seconds that nomination.
  • Charge people a $ fee for each published item that they own. You can have as many items as you like, provided you pay for them.
  • Each month, the CEO will visit a page at random on the intranet. If the content is up-to-date, the content owner gets a small reward. If the content is lousy, the content owner has to perform some kind of community service.
  • If a page gets no views over a 12 month period then automatically cull it.
  • Add a “delete this page if junk” button to every page that any employee can use.

Adrian Howard described how a radical cull of wiki content was more acceptable when the process was at least partly automatic. Another upside:

There was also a nice side effect: Because we left the system running people felt able to experiment a bit more – knowing that unused stuff would be automatically culled. A sort of pave-the-cowpaths for content.

When Richard said he was stuck with a CMS that was a piece of junk, one member suggested getting a second CMS to manage the first one! Every intranet team faces some rough realities:

  • Every piece of content, in principle, is owned by a staff member (but the owner may not know it).
  • Staff move, resign, change jobs, forget, and have human weaknesses.
  • Some combination of technology and human control is required.
  • Culling content by humans alone is a time-consuming and sensitive task.

Hilary Marsh requested the following simple system from IT—but would it work for a 300,000 page intranet?

  • A “content expiration” field in the CMS (which didn’t have any functionality associated with it). We filled in the field manually for each piece of content based on the rules we set for various content types.
  • A monthly report of content set to “expire” in the coming month
  • A way to archive content so it would remain live on the site but not be returned in general searches

As all intranets tend towards obesity by default, imagine the impact when social media is/are added to every intranet’s menu.

Join contentstrategy at googlegroups.com and follow the whole discussion.
Image of Mr Creosote (c) MontyPython?

{ 0 comments }

Style Guides: Economist, New Harts, Style Manual, Yahoo!How to punctuate ‘do’s and don’ts’? The experts disagree, so choose a rule and stick to it. Debate is pointless, and life is short.

A member of the TWIN (Technical Writers of India) group asked recently:

Just a quick one, what’s the correct punctuation in “Dos and Don’ts”?

Please… please don’t send me back to google, it has left me more confused than from when I started…

This is a genuinely messy little problem, and it’s no wonder it confuses nearly everyone. Here’s why you need to choose a style guide and accept its advice, or establish your own rule and stick to it.

There’s one universally accepted rule:
Don’t use an apostrophe to indicate plural.

And also a rule for exceptions, which is not universally accepted:
But do use an apostrophe to indicate plural for some small words where the meaning may be unclear.

CORRECT (everyone agrees): ‘PCs’
CORRECT (everyone agrees): ‘Dot the i’s and cross the t’s.’

But when we look at Dos (or Dos) and Don’ts (or Don’t's), that’s messy. It’s impossible to be both consistent and clear, because dos looks like a programming term to some people, but don’t's looks pretty crazy with two apostrophes. And when a word looks pretty crazy, that is a valid reason for not writing it.

Here are the (conflicting) verdicts from style guides I respect.

1. The Economist Style Guide:
CORRECT: Dos and don’ts.
(They call the plural possessive a false possessive and instruct: Do not commit this sin.

2. Style Manual, revised by Snooks and Co.
CORRECT: Dos and don’ts.
(Only allows plural apostrophe for plural of letters, e.g. p’s and q’s.

3. Yahoo! Style Guide:
CORRECT: Do’s and don’ts.
(Allows plural apostrophe for plural of letters and words that would be confusing without an apostrophe.)

4. New Hart’s Rules
CORRECT: you must decide for yourself.
(Allows plural apostrophe when clarity calls for it.)

Now choose your rule and stick to it. I hope you can see why it is pointless to hope to solve this problem with logic, and pointless to debate it. The four writers who responded with specific advice did not agree, and yet they were all correct.

Oh the joys of grammar! We think the rules are chiseled in marble. If we ‘know a rule’, we are sure it is right. In fact, many are debatable—and some people enjoy a hearty grammar debate. As for me, I aim for consistency and commonsense. And I often fail, as you will notice in this very blog post.

{ 2 comments }

Writing tip: Use a template in Word to improve accessibility

30 March 2012

Always use an appropriate template for documents that you write at work. If they’re good templates and you use them well, you are more than half-way to achieving an accessible document. It’s easy to pooh-pooh MS Word as a tool. It’s so familiar. You have been using it for years. In your heart of hearts, [...]

Read the full article →

WCAG 2.0 undermined by 3 generations of digital illiteracy

11 March 2012

Will the problems of digital illiteracy shrink as new generations of staff move through the workforce? I was asked this question yet again this morning at my daughter’s baby shower. (Clearly, there’s no escape!) No, the problems won’t shrink, because people are people. The problems will just keep changing. That’s why training general staff in [...]

Read the full article →

Diploma in Accessible Content coming in March 2012

22 February 2012

We’re almost ready! What every organization needs, if they’re producing official information, is content that complies with WCAG 2.0. Even when a web site is brilliantly accessible behind the scenes, it can fail if the content fails. WCAG 2.0 compliance is for many organizations a huge and pressing problem. When governments commit to complying with [...]

Read the full article →

The value of good business coaching: extreme

10 February 2012

Good business coaching pushed our business ahead when we needed it. Business coach Karl Baker made us aware of many things outside the ken of a typical start-up owner. He did this by being 100% on our side, and yet objective. He acted as cheerleader and held us to account. He asked many open-ended questions, [...]

Read the full article →

Active verbs: Occupy and Don’t Swear

31 January 2012

Today’s the day the Occupy Wellington people have been removed by police from their camping site in Civic Square. I’m not about to pontificate on the wrongs and rights, the origins and developments of the Occupy movement—although I have an unfortunate fondness for pontificating, and I believe, a certain talent. I’ve been musing on activeness [...]

Read the full article →

Fine-tuning link-text: if the headline ain’t broke, don’t fix it

25 January 2012

Hi Rachel We have a couple of questions about link-text. If it’s not too much trouble, we’d like your opinion. We can’t find the answers anywhere. Question 1:  When you are linking to another page on the same website, should the link text be exactly the same as the page title that you are linking [...]

Read the full article →

Writing tip: Watch the wicked ‘which’

17 January 2012

A sentence containing the word which can have correct grammar and yet still be hopelessly unclear. Run a safety check every time you use which in mid-sentence, referring to something earlier in the sentence. You may know what you mean, but does your reader? The following sentence is an example: The janitor revised the nursing [...]

Read the full article →