The One-Click-What? Phenomenon

Nearly a year ago I marveled at the design of Rapidshare, which bills itself as the world's biggest 1-click file hoster or some such rubbish. The same applies to documents.

It's easy for technical writers to get caught up in the marvel of formatting. When you're writing for utter fucking morons (and the canonical presumption of end-user documentation is that they are), you want to break down the information into chunks as small as possible and feed these to your reader individually. So you avoid long sentences and long paragraphs, use plenty of screenshots, all sorts of pretty colored fonts with dropped shadows and plenty of whitespace - to differentiate conceptually separate items.

But if you're not careful, at some point you'll end up with a page that looks like the front page of Rapidshare, and that makes your document unuseable. People have a specific expectation of how information is presented. It may be difficult to find your spot again on a page of uniform text after you've looked away, but it's a skill that anybody who has ever read a book in more than one sitting possesses.

The basic dichotomy of documentation is that of a manual versus a help file. People are meant to read a manual, and look up a help file. Naturally they won't actually sit down with your manual in front of a cozy fire one winter's evening (unless it is to ceremonially convert the printout to kindling), but there's a method to the madness. Manuals are things people look up when they have no other choice, and if they're that stumped, you might as well force them to read through more than half a paragraph and learn something useful. They're sufficiently open to it at that point. Of course, it is possible to make a manual useless by neglecting effective navigation (of which markup is a part), but it's a fine line that you will simply have to find, by talent or skill.

But a page full of needless whitespace, seemingly arbitrary indentation and drop-shadow fonts is a greater crime still. Finding data on a sheet of plain text is difficult enough, but ask the human mind to parse an overly formatted page at a glance, and it will shut down due to insufficient computing resources. This is the One-Click What? Phenomenon, or, if you wish, the WTF effect.

I'm probably over-simplifying, and I know my boss (who reads this blog) will kick my ass for saying this, but if you can't make your page readable using MS Word's default headings 1 through 3 and paragraph breaks, then you're simply not trying hard enough.

Estonica: Presidential

The term of the current President of Estonia is running out soon. They're electing a new one.

There are currently two contenders. The incumbent is a familiar figure who used to run the country in the Soviet days, and was then involved in the liberation movement. The other is an American expat, son of WWII-era refugees, that came back to Estonia after 1991.

The Soviet guy is supported by the party that controls the capital and the biggest single chunk of the popular vote. The American guy is supported by the ruling coalition. The smear campaigns have been in full force for weeks.

Here's the kicker: not only doesn't the President of Estonia have any political power, but he's not even elected directly. The parliament had its chance, but the coalition fell three votes short of the necessarity majority. The opposition simply didn't show up for the vote, afraid of renegades in their own ranks. Now it's up to a caucus made up of representatives from local governments. The opposition carried the capital and gave no delegates to the coalition; the coalition carried the second biggest city and returned the favor. Some local councils were deadlocked and failed to elect any representatives at all.

Estonia is a multiparty parliamentary republic where prime ministers don't make it from one general election to the next. It's small enough that the politicians are kept in check more or less effectively. There isn't really a significant difference in platforms, and a voter's choice comes down simply to who you dislike less.

As a result, politics in Estonia is an inconsequential soap opera, with a familiar cast of fumbling characters. You can observe it with curiosity or incredulity. Or even annoyance.

Estonia's national football team has a specific pattern for home games: they look really good, have a bunch of feasible shots on goal. Ocasionally they'll pull off a nil-nil draw against Croatia or a noble 0-1 loss against Portugal, off an interdimensional fluke in their defense. You always feel like they're about to pull off something awesome, a brilliant flash of competence. And then they inexplicably crash and burn.

Estonia's political scene is much the same.