Making them up as I go (2)

1. Tell the truth.
2. Entice, or fail.
3. To emphasize, summarize.
4. If it ain't short, it don't work.
5. Be clear.


And so I don't forget:
Don't explain. Just tell a story.
Don't argue. Just say things that make sense.
Expect people to be bored by the writing, and shorten it.
Make the wording easy to take.

Remove Loose Ends -- the interesting one-liners that go nowhere.

Wednesday, December 30, 2015

The better word

I may have mentioned this already: My method of proofreading is to start at the beginning and read until I have to change something, then change it, then start at the beginning again.

It's a good method and I rely on it. But sometimes it gets to be days and days of proofreading and I'm still on page two.

(Yeah, this is one of those times. Counterfactuals and the Common Trend on my Econ blog, if it ever gets finished.)

It's hard work. But re-reading the sentence with the better word is always satisfying.

Oh hey, Happy New Year.

Tuesday, November 24, 2015

That would be who

From Investopedia:
The Employment Cost Index (ECI) is a quarterly report of compensation costs that is released in the final month of the quarter... All non-farm industries are covered, with the exception of federal government employees (which only make up 2-3% of the work force).
Federal government employees are people. For people, we use the word "who". Therefore:
... federal government employees (who only make up 2-3% of the work force).

For the opposite case, see WHICH, not WHO

//

Didn't know the Federal workforce was so small, did you.

Sunday, November 15, 2015

Quality

From Chapter 17 of
Zen and the Art of Motorcycle Maintenance
by Robert M. Pirsig

To reinforce the idea that they already knew what Quality was he developed a routine in which he read four student papers in class and had everyone rank them in estimated order of Quality on a slip of paper. He did the same himself. He collected the slips, tallied them on the blackboard and averaged the rankings for an overall class opinion. Then he would reveal his own rankings, and this would almost always be close to, if not identical with the class average...

At first the classes were excited by this exercise, but as time went on they became bored. What he meant by Quality was obvious. They obviously knew what it was too, and so they lost interest in listening. Their question now was "All right, we know what Quality is. How do we get it?" ...

He singled out aspects of Quality such as unity, vividness, authority, economy, sensitivity, clarity, emphasis, flow, suspense, brilliance, precision, proportion, depth and so on; kept each of these as poorly defined as Quality itself, but demonstrated them by the same class reading techniques. He showed how the aspect of Quality called unity, the hanging-togetherness of a story, could be improved with a technique called an outline...

Now, in answer to that eternal student question, How do I do this? that had frustrated him to the point of resignation, he could reply, "It doesn't make a bit of difference how you do it! Just so it's good!" The reluctant student might ask in class, "But how do we know what's good?" but almost before the question was out of his mouth he would realize the answer had already been supplied. Some other student would usually tell him, "You just see it." If he said, "No, I don't," he'd be told, "Yes, you do. He proved it." The student was finally and completely trapped into making quality judgments for himself. And it was just exactly this and nothing else that taught him to write.

Sunday, November 8, 2015

Bernanke he will Rogoff, even weather if

I don't care what your name is and who your friends are; it is careless and inconsiderate to write like this:
I cannot claim—we cannot claim—to know whether Bernanke he will Rogoff or Krugman and Summers are correct here, or even weather if Bernanke he and his committee had found the nerve, and rolled double-or-nothing one more time to boost the American high-powered money stock to $9 trillion, we might have been back to full prosperity a couple of years ago.

Friday, November 6, 2015

Blattman on Klein on Better Communication

Chris Blattman summarizes Ezra Klein's talk on how to popularize research.

Key points:

1. "Tell people what’s new and surprising right away, and tell them immediately what they should walk away thinking."

2. "... start telling people why they should read in the title."

3. "... it helps to link your work to the broader issues that people care about."

4. "People like and share things that help them establish or reinforce an identity."

Sunday, October 25, 2015

"Hardly anything is known of it except its fame"


Via Orange Crate Art, two wonderful paragraphs by Alberto Manguel at the New York Times.

Plato, in the “Timaeus,” says that when one of the wisest men of Greece, the statesman Solon, visited Egypt, he was told by an old priest that the Greeks were like mere children because they possessed no truly ancient traditions or notions “gray with time.” In Egypt, the priest continued proudly, “there is nothing great or beautiful or remarkable that is done here, or in your country, or in any other land that has not been long since put into writing and preserved in our temples.”

Such colossal ambition coalesced under the Ptolemaic dynasty. In the third century B.C., more than half a century after Plato wrote his dialogues, the kings ordered that every book in the known world be collected and placed in the great library they had founded in Alexandria. Hardly anything is known of it except its fame: neither its site (it was perhaps a section of the House of the Muses) nor how it was used, nor even how it came to its end. Yet, as one of history’s most distinguished ghosts, the Library of Alexandria became the archetype of all libraries.

Hardly anything is known of it except its fame: neither its site, nor how it was used, nor how it came to its end.

Calls this to mind:

And on the pedestal these words appear:
`My name is Ozymandias, King of Kings:
Look on my works, ye mighty, and despair!'
Nothing beside remains.

Monday, October 12, 2015

We protect your clarity, your illiteracy, and write blog posts


The comma is often used to present a list of items. Here is an example from my Google Search screen this morning:


How we understand the list depends on the context; the context is provided primarily by the words that come before the list. When I read that blurb on my screen, this is how it came into my brain:

"We protect your privacy, we protect your data, and we protect put you in control. No that's not right. I think they mean 'We protect your privacy and your data, and put you in control.'"

I don't know what they mean, really, since they didn't say it clearly.

//

The problem is that the context, the "We protect", as presented, applies to the whole list. That means the words "we protect" are used with each element on the list. Even the third element. That's how I got "we protect put you in control" which is obviously incorrect.

To make the correction, I changed their ONE list of THREE things to TWO lists of TWO things each. My one list is a list of things that they protect ("your privacy and your data"). My other list is things they do ("We protect [you] ... and put you in control").

Am I making a mountain of a mole hill? I don't know. Does it matter to say what you mean?

//

I hope you find the title of this post objectionable.

Sunday, October 4, 2015

"One of our viewers are in Bermuda"


That's what the news anchor said just now: "One of our viewers are in Bermuda".

IS, you illiterate bitch. ONE IS.

Errors in English reflect errors in reasoning. Not always, of course. But the difference between ONE and MORE THAN ONE is pretty simple, really.

Maybe all of their viewers are in Bermuda, I don't know. Well, I'm not in Bermuda. Maybe most of their viewers are in Bermuda. That's fine. But if the bitch knows about ONE of them, then it is ONE viewer IS in Bermuda.

Which viewer? One of our viewers. One of our viewers is in Bermuda.

Why should I listen to any of the news the bitch reports, if she cannot properly express the difference between "one" and "more than one"?

Sunday, September 13, 2015

The Pause Between Words


The TV advertisement shows big bold print:

NEXIUM
LEVEL
PROTECTION

I'm thinking it's an ad for Nexium, so they want me to think of "nexium level" as "high level" or "strongest" or "best" or something like that. That's fine, that's what an advertisement is supposed to do.

But -- words still on-screen -- the announcer's voice comes over, repeating those words.

"Nexium," he says. "Level protection."

//

Here, let me do it with punctuation:

I expect the announcer to say Nexium-level protection. (A shorter pause before the word level than after.)

But what he says is Nexium: Level protection. (A longer pause before the word level than after.)

"Nexium-level" is a high level, presumably. But that's not what the announcer offers. He offers Nexium to us as "level protection". Flat, I guess, flat, uninspiring, average or maybe below average protection. Level protection, as opposed to Nexium-level. That's what the announcer offers.

Why? Because the announcer paused a little too long after the word "Nexium". He put the big space between "nexium" and "level" when he should have put it between "level" and "protection".

//

Did they not notice? It cannot be. They had to notice. But they kept it that way, so that what the announcer says comes across like an insult to the product. Too subtle to be funny, though.

Why do it that way?

Dunno. General illiteracy, perhaps? Cultivated illiteracy?

I can't say.

Wednesday, August 26, 2015

WHICH, not WHO


At Seeking Alpha:
However, the company is actually currently undervalued and that makes now the right time to buy the stock at a bargain price. The British company, who boasts an impressive US$4.003 billion profit ...
The company, which boasts an impressive profit. Despite what you may have heard, a corporation is not a person. It is an organization. The word "who" does not apply.

A corporation may be legally a person, but it is not literally a person. And you do wish to be literate, don't you, in your writing?

Thursday, July 30, 2015

Structure and focus

Bryan Garner's LawProse Lesson #214:
Lawyers’ biggest failing as writers.

What’s the most pervasive flaw among legal writers? It’s the tendency to begin writing before fully understanding the message to be conveyed. Lawyers often don’t think through what they want to say until they’re already writing—and they therefore meander, backtrack, and even restart. Unless they spend a great deal of time rewriting and cutting, they end up submitting something verbose, rambling, repetitious, incohesive, and unpersuasive.

The mature writer first figures out the major propositions and then writes in support of them. The resulting product has both an overt structure and a strong focus.

This method of writing isn’t inborn; it’s learned. With some patience and humility, anyone can learn to do it.

Sometimes I use writing to explore ideas. That counts as "writing before fully understanding the message to be conveyed." Probably unfocused and unpersuasive. But sometimes that's okay.

Actually, for writing about the economy, I count is as a plus if ideas are presented for evaluation rather than crammed down your throat as the hard truth.

It's different for lawyers, I think. Oh, and there are some arguments I make, where I am as focused and convincing as possible. When I'm sure of something and when it's important.

But even the things we're sure of -- especially the things we're sure of -- occasionally need to be reconsidered, thought through again, seen in the light of a changed economy. A changing economy.

Saturday, May 16, 2015

Friday, May 8, 2015

It has to look right

In high school I took an art class. We had to draw stuff and paint stuff, you know. (I'm such an aficionado!) There was an odd-looking tree outside our house, and I painted that. The teacher didn't like it.

I wish I could remember her name.

It was a big old tree, with a tiny little branch sticking out the side of it a foot or two above the ground. Weird: trees don't look like that. That was why I wanted to paint it.

Well, that was also why the teacher didn't like it. It didn't look right.

I didn't understand her complaint at the time. That was what the tree looked like. But that wasn't good enough for my art teacher.

I understand now. If you were looking at the tree, you could see what it looked like. You could see it was an odd-looking tree. But if you were looking at my painting of the tree, you could only see that it was an odd-looking painting.

//

I was awakened by the phrase as rich as Croesus in my head this morning -- left-over from a recent post on my econ blog. So I started looking for stuff on Croesus on the internet. Found something that made me want to write this post.

From Sardis (the capital of Lydia in the time of King Croesus) at the Metropolitan Museum of Art:
In 133 B.C., Sardis came under Roman rule ... By the end of the first century B.C., it had become an important center of Christianity...
C'mon. There still wasn't Christianity yet, by the end of the first century B.C.

Or hey, maybe there was. But it sure doesn't look right.

If the Sardis article has its facts right, the wording should have been tweaked so that the odd little branch on their tree doesn't stick out like that.

Saturday, February 21, 2015

FRED Adds 5,466 Series of Earnings Data

FRED:
FRED has added 5,466 series of earnings data from the Bureau of Labor Statistics Current Population Survey. Categories include (among others) age, race, sex, occupation, full- or part-time status, and educational attainment.
Posted in FRED Announcements...

Depending on the meaning of the word include, the sequence "(among others)" is either important, or unnecessary.

Based on the meaning of the word include, then, the sequence "(among others)" is unnecessary.

Anyway, you always want to favor fewer words.