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.