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.

Tuesday, April 18, 2017

Illiterate versus Just Plain Stupid

From W3Schools: "Tip: The <div> element is very often used together with CSS, to layout a web page."

No. Unacceptable. It has to be this way: "Tip: The <div> element is very often used together with CSS, to lay out a web page."

"Lay out" has to be two words. Why? IMAGINE THAT YOU ARE DOING IT. Then you have to be able to say: "I am laying out the web page." Two words.

It would be obviously wrong to say "I am layouting the web page." It would be stupid. I know the Age of Reason is behind us and all, but that doesn't mean this has to be the Age of Stupidity. Don't go there.

It would be okay to say "I am working on the layout" because the layout is a thing. But you would never say "I am workoning the layout," right?

Saturday, April 15, 2017

"This is reality, whether you like it or not."

The title is from Willa Cather, at Orange Crate Art. It reminds me...

I worked for a time with a bunch of foreigners, Czechs from Czechoslovakia, from before the days of the Czech Republic. There were minor problems with the language.

The boss and his number one man didn't get along at all. Number one never liked anything the boss thought we should do. One time the boss said we should do so-and-so. Number one responded, saying "I don't like that..."

The boss replied, saying we would do it anyway, "whether you don't like it or not."

It was just perfect.

Thursday, April 6, 2017

Maybe a comma after "literally" would help

Some years back, in The Atlantic:
But the federal government stuck to its guns, literally suppressing an armed anti-tax uprising in western Pennsylvania in 1794, known as the Whiskey Rebellion.
That sentence would have been so much better if the word "literally" applied to the imagery of sticking to guns, rather than to the fact of suppressing a rebellion.