Tuesday, 20 August 2013

There are rules


Many experts, through much research, have compiled golden rules of
documentation writing. These rules apply regardless of medium:

• Use short, simple, familiar words
• Avoid jargon.
• Use culture-and-gender-neutral language.
• Use correct grammar, punctuation, and spelling.
• Use simple sentences, active voice, and present tense.
• Begin instructions in the imperative mode by starting sentences with
an action verb.
• Use simple graphic elements such as bulleted lists and numbered
steps to make information visually accessible.

From: The Principles of Readability

get it here, http://www.impact-information.com/impactinfo/readability02.pdf

Flesch–Kincaid readability tests

from Wikipedia,


yeah,


I KNOW!

http://en.wikipedia.org/wiki/Flesch-Kincaid_readability_test

The Flesch/Flesch–Kincaid readability tests are readability tests designed to indicate comprehension difficulty when reading a passage of contemporary academic English. There are two tests, the Flesch Reading Ease, and the Flesch–Kincaid Grade Level. Although they use the same core measures (word length and sentence length), they have different weighting factors. The results of the two tests correlate approximately inversely: a text with a comparatively high score on the Reading Ease test should have a lower score on the Grade Level test. Rudolf Flesch devised both systems while J. Peter Kincaid developed the latter for the United States Navy. Such readability tests suggest that many Wikipedia articles may be "too sophisticated" for their readers.[1]

more at link...

there's a software....
http://www.gnu.org/software/diction/

Google reading levels


February 16, 2011


More About Google's Reading Level Filter

Google's Daniel M. Russell has more information about the reading level filter, a feature recently added to the advanced search page.

The reading-level is based primarily on statistical models we built with the help of teachers. We paid teachers to classify pages for different reading levels, and then took their classifications to build a model of the intrinsic complexity of the text. (...) We also used data from Google Scholar, since most of the articles in Scholar are considered advanced.

So the breakdown isn't grade- or age-specific, but reflects the judgments of teachers as to overall level of difficulty. Roughly speaking, "Basic" is elementary level texts, while "Intermediate" is anything above that level up to technical and scholarly articles, a la the articles you'd find in Scholar.

That's not exact, but it's a fairly robust model that works across a wide variety of different text styles and web pages.

http://googlesystem.blogspot.ca/2011/02/more-about-googles-reading-level-filter.html 

Google's UK newspaper reading level scores


http://www.malcolmcoles.co.uk/blog/googles-reading-level-scores-newspapers/

Google’s reading level scores for UK newspapers

Google's launched a new feature that analyzes reading level scores for websites. Here are the scores for national UK newspapers, plus the overall verdict Google gives on the site's reading level.
There's no right score - it depends on the audience, of course. These are ordered by basic score - the order's fairly surprising (though that may say more about Google's scores ...)

Sun

Overall reading level according to Google: Basic
Sun
Sun

FT

Overall reading level according to Google: Intermediate
FT
FT

Guardian

Overall reading level according to Google: Intermediate
Guardian
Guardian

Daily Mail

Overall reading level according to Google: Intermediate
Daily Mail
Daily Mail

Mirror

Overall reading level according to Google: Basic
Mirror
Mirror

Times

Overall reading level according to Google: Intermediate
The Times
The Times

Express

Overall reading level according to Google: Basic (which makes little sense given the graph ...)
Express
Express

Telegraph

Overall reading level according to Google: Intermediate
Telegraph
Telegraph

Independent

Overall reading level according to Google: Intermediate
Independent
Independent

plain language


http://www.impact-information.com/impactinfo/newsletter/plwork15.htm

Plain Language at Work Newsletter
15 May 2005 Number 15





Victims of Fog Creep

What's With the Newspapers?

BEGINNING around 1964, the circulations of the daily newspapers in the U.S. began steadily to decline at a compound rate of approximately half a percent per year. Every year, the reaction of most of the publishers was to state that the decline was a short-term trend that would soon reverse.
But by 1999 the rate of decline began to accelerate. Daily newspapers began to have annual reductions of one to two percent. Publishers were quick to blame the Web and the free online publishing of the newspapers' stories. What they had conveniently forgotten was that their own research for the past 20 years had been predicting these declines, predictions made well before the arrival of the Internet.
What they also forgot were the lessons of plain language.

Hedging on Circulation Figures

The newspapers may be in more trouble than they care to admit. Their circulation figures are often inflated to win advertisers. They are not accurate reflections of the number of people who actually open and read a newspaper on a regular basis.
A large part of circulation figures consists of bulk sales to institutions like hotels and airlines. Another ten percent are copies given to schools.
A another problem is that large numbers of those who subscribe do not actually read the paper. There is an enormous turnover in subscriptions, with a good half failing to re-subscribe each year. The arrival of the "Do not call" lists was a tremendous blow to the newspapers, as it cut back on efforts to replenish subscribers.

Smaller is Better

Actual numbers of news readers are higher than ever, but many now go to the Web for news, especially young people. For them, Web news does not destroy forests, and it does not clutter their apartment.
In response to this challenge, publishers are re-discovering old lessons such as smaller newspapers are more likely to be read. The stately London Times, for example, went to a tabloid format last November, resulting in a reported 30,000 boost in sales.
Several newspapers in Europe have taken to printing small "commuter tabloids" that are distributed free. Like the alternative papers in the U.S., they are counting on advertising, not subscriptions, to pay for them.

The Most and Least Readable

The Daily Mirror has one of the largest circulations in the world. It also advertises itself as "The Best Newspaper on the Web" and might well be. You can access large amounts of information very rapidly.
Even British tabloids such as the Sun and Daily Mirror, both written at the 9th-grade level, are starting to lose circulation, along with the American tabloids such as the National Enquirer, the Globe, and the Star.
The Times of India, at the 15th-grade level, may be the most difficult newspaper in the world to read. It also has one of the most cluttered Web sites.

Flesch and Gunning—The Fog Busters

The truth is, many newspapers have become too difficult for most adults to read.
To save readers and advertising, publishers have to do more than change the format of their newspapers or go to the Web. They also have to look up old lessons from Rudolph Flesch and Robert Gunning, who worked with newspapers and wire services to improve readability. Flesch worked with the Associated Press and Gunning with United Press.
During the period from the beginning of the New Deal to the end of World War II, newspapers had climbed steadily in reading difficulty. The work of Flesch and Gunning in the 40s and 50s gave them new life. They lowered average reading level of the newspapers from the 12th to the 9th grade. The reading level of the United Press dispatches went from the 16th to the 11th grade.
The results were considered something of a miracle at the time. Newspaper readership increased up to 45 percent. One 1948 study in the Journalism Quarterly showed that lowering the reading difficulty of a newspaper from the 13th to the 6th grade increased the number of paragraphs read by 93.11 percent.
Alan Gould, Executive Editor of Associated Press wrote in 1949:
"It is no exaggeration to say that the impact of Doctor Flesch's ideas on simpler, clearer ways of writing represents one of the most significant developments of our journalistic times. The effect has been to make more readable—and, therefore, more understandable—the combined output of the three great media of free expression in the United States: the newspapers, the magazines, and the radio.
"The rapidity with which Doctor Flesh has achieved results on the American writing scene is due, I suggest, to two main factors:
(a) his own skill in presenting a novel formula for Readability, and
(b) the extent to which it has been applied effectively to news writing. A Flesch axiom—"Write as you talk"— is now widely accepted by newspapermen who scoffed at the doctor's ideas when they began emerging from collegiate classrooms.
"The answers are simple enough, as the doctor has demonstrated and our own Associated Press staff has proved. The basic answer is this: newspaper readers or radio listeners have a better chance of grasping the news, or what it means, if it is told to them simply and clearly."

The Magazine Evidence

Both Flesch and Gunning extensively studied the relationship between the readability of popular periodicals and their circulations, shown in the following charts.
Rudolph Flesch Magazine Chart (1949)
StyleFlesch Reading Ease ScoreAverage Sentence Length in WordsAverage No. of Syll. Per 100 WordsType of MagazineEstimated School Grade CompletedEstimated Percent of U.S. Adults
Very Easy90 to 1008 or less123 or lessComics4th grade93
Easy80 to 9011131Pulp fiction5th grade91
Fairly Easy70 to 8014139Slick fiction6th grade88
Standard60 to 7017147Digests7th or 8th grades83
Fairly Difficult50 to 6021155QualitySome high school54
Difficult30 to 5025167AcademicHigh school or some college33
Very Difficult0 to 3029 or more192 or moreScientificCollege4.5

Robert Gunning Magazine Chart (1952)
GroupApprox. Total CirculationAverage Sentence LengthPercentage of Hard WordsTotalFog Index
ClassFewer than 1 million20103012
NewsAbout 3 million16102610
Reader's Digest8 million157229
SlicksMore than 10 million155208
PulpsMore than 10 million153166

Today's publications

The following chart of current publications also reveals readability patterns. We obtained the grade-level figures by applying the Dale-Chall original formula to at least 4,000 words from front-page news stories and feature articles in each of the publications.
Grade Level and Circulation of Current Periodicals
PeriodicalGrade LevelCirculation
Times of India152,144,842
London Times12619,682
Los Angeles Times121,292,274
Boston Globe12707,813
National Enquirer122,760,000
Sydney Sun-Herald12393,000
China Daily121,000,000+
Atlantic Monthly111,500,000
Better Homes and Gardens117,628,424
Atlanta Constitution11606,246
Cleveland Plain Dealer11479,131
San Jose Mercury News11298,067
New Yorker101,900,000
New York Times101,680,583
Washington Post101,007,487
USA Today102,665,815
TV Guide913,200,000
The Sun (UK Tabloid)93,541,002
Daily Mirror (UK Tabloid)92,148,058
Harpers9230,159
Time94,114,137
Reader's Digest912,212,040
Notice that:
  • Two magazines with the largest circulations in the world, TV Guideand Readers Digest, are written at the 9th-grade reading level.
  • The newspaper with the largest circulation in the world, the Sun, is written at the 9th-grade reading level.
  • USA Today is written at the 10th-grade level.

The Blockbusters

If some newspaper editors still argue that plain language cannot be expressive and vigorous, they should look at what novelists can do with it. These top-selling U.S. authors all write at the 7th-grade level:
  • John Grisham
  • Tom Clancy
  • Michael Crichton
  • Stephen King
  • Clive Cussler
  • Mary Renault
  • Frank McCourt
  • Arthur Golden

The Romance Novels

Perhaps the biggest success story in publishing is that of the romance novels, which are often written at the 5th-grade level:
  • Romance fiction generated $1.63 billion in sales in 2002.
  • There were 2,169 romance titles released in that year.
  • Romance fiction comprises 18% of all books sold (not including children’s books).
  • Romance fiction comprises 53.3% of all popular paperback fiction sold in North America.
  • Romance fiction comprises 34.6% of all popular fiction sold.

The Master Speaks

"I notice that you use plain, simple language, short words, and brief sentences. That is the way to write English—it is the modern way and the best way. Stick to it; and don't let the fluff and flowers and verbosity creep in.
"When you catch an adjective, kill it. No, I don't mean utterly, but kill most of them—then the rest will be valuable. They weaken when close together. They give strength when they are wide apart."
—Mark Twain, in a letter to a 12-year-old boy.
Mark Twain wrote his masterpieces like Huckleberry Finn and his non-fiction books like Roughing It at the fifth-grade level. He wrote his essays at the 7th-grade level.
If there is any lesson we can draw from over a hundred years of research and practice, it is that people read what they find comfortable to read, that is, materials that match their reading ability. Today, people want news that is convenient to access, concise, independent, and most of all easy-to-read.
Knowing all this, why would any newspaper editor or teacher of journalism not encourage writers to write at a 7th-grade level? Why not write at a reading level that matches the reading ability of the average American adult?
It will do more than help save the newspapers. It might give us a few more millionaire authors.

Friday, 7 December 2012

Ted talk on branding

Find it here

I'll embed it later
When I'm not posting with my iPad.