Hate UML?

Draw sequence diagrams in seconds.
http://www.websequencediagrams.com

Automatically remove wordiness from your writing
Posted on: 2009-03-04 11:37:18

Show/Hide Changes

I recently started re-reading William Zinsser's On Writing Well. Zinsser emphasizes simplicity in writing. To reduce wordiness, he implores the writer to remove needless words and phrases:

"I might add," "It should be pointed out," "It is interesting to note that" how many sentences begin with these dreary clauses announcing what the writer is going to do next? If you might add, add it. If it should be pointed out, point it out. If it is interesting to note, make it interesting. Being told that something is interesting is the surest way of tempting the reader to find it dull; are we not all stupefied by what follows when someone says, "This will interest you"? As for the inflated prepositions and conjunctions, they are the innumerable phrases like "with the possible exception of" (except), "due to the fact that" (because), "he totally lacked the ability to" (he couldn't), "until such time as" (until), "for the purpose of" (for).

It's not only dry corporation speak that you should worry about. Actually, what I mean to say is that a little bit of wordiness totally creeps into informal writing way more than you'd think. If you do any sort of writing on the web, you seriously need to think about editing, and more often than not, this tool can help point out some bad habits.

You might be concerned that your writing will loose its personality. Zinsser goes on to say:

You will reach for gaudy similes and tinseled adjectives, as if "style" were something you could buy at a style store and drape onto your words in bright decorator colors. (Decorator colors are the colors that decorators come in.) Resist this shopping expedition: there is no style store. ... Style is organic to the person doing the writing, as much a part of him as his hair, or, if he is bald, his lack of it. Trying to add style is like adding a toupee.

You don't want your blog to wear a toupee, do you? Writing style isn't about needless words. Once you remove them, your thoughts will shine through, clearer and more powerful, and then you can then build them back up. This takes time, but your readers will appreciate it.

By using sources on the web, I came up with about 600 simple substitution rules to cut out wordy phrases, and encoded them into a python script. Along with other sources, I used Jeff Atwood's Coding Horror blog to train it, [edit] as he seems to have a high wordiness factor, because I wondered if I could get a web celebrity to notice my little blog, and it totally worked.

Try it out above. Paste your entire blog article, essay, or email into it. Download the python source here.

Unfortunately Internet explorer 6 has some problem with my code...

You might also be interested in:

Post comment

Real Name:
Your Email (Not displayed):

Text only. No HTML. If you write "http:" your message will be ignored.
Choose an edit password if you want to be able to edit or delete your comment later.
Editing Password (Optional):

kjk

2009-03-07 22:55:20

First, let me review a bit of history from my (rather biased) perspective. M was given and doggedly maintained sole responsibility for the expenditures and accounting associated with the Rebuilding Project, including single signature responsibility. He assumed that his responsibility was fulfilled completely by reporting month after month that the Project was “on schedule and on budget”. The Finance Committee volunteered B, a trained accounting professional, to create and support the appropriate financial records. This offer was rejected. Instead, A was appointed by M to fulfill this role, despite his apparent lack of skills in this area. A year later, in A’s own words, there are “no records” (invoices, checks, etc.), which document and account for our activities. A even has this wrong; M working with C, our external accountant, has now completed reconciliation of the bank statements through 2007. However, we do lack the associated invoices.

Steve Hanov

2009-03-08 11:14:28
kjk: If you are not a spam-bot, thanks for the sample.

My approach only substitutes or eliminates words. It can't revise a lot of your text, because it goes beyond simple substitution. Only the author can change a sentence from the passive to the active voice. For example, to change "M was given", we need to decide who did the giving, and then write something like "The company gave M..."

Jeff Atwood

2009-03-15 01:46:55
I demand a recount. :(

chakrit

2009-03-15 02:30:20
This was made for twitter, no? :-)

Niyaz PK

2009-03-15 12:43:18
I tried one of my blog entries and it did not remove even a single word! Here is the post:

Whenever you are discussing about doing something in a group, there is a question you should ask. It is the most important question. It will make or break your work.

It is NOT “Who all are interested in the idea?”

It is “Who all are not really interested?”

The people who are not interested in doing something great, people who are pissed off by the idea of being great, and lazy people, and great eaters, and great sleepers, and people who do not talk, can lower the morale of your group significantly, and eventually you will drop your great idea. Better, drop those people.

pbhj

2009-03-23 16:28:50
"Your writing - cut words"

65% less syllables.

Abram

2009-04-14 18:06:16
I think we are moving much too far in the direction of simplification. One of the reasons many older works, both of fiction and non-fiction, are more enjoyable to read for many of us is that the language tends to be much richer and sentences longer and their structure more complex. There are a few modern novelists who reject the notion that everything needs to be simplified and shortened and hence write wonderfully rich, engaging literature. I can understand shortening and simplifying business language, but that's about it.

ham

2009-04-16 00:27:07
hmm... the reverse would be useful if you had to write a 1000 word essay and were short some words ... run your essay through this and voila, make it wordlier :p

Joe H.

2009-04-16 09:58:15
Thank you for your thought-provoking article. I tend to be grumpy in the morning, so I would like to know how I can "loose my friendly feeling" in my writing.

Iain

2009-04-26 16:45:39
I don't like that it rewrites your text. You have to diff the result yourself, especially since its simple algorithm mangles some things, like your first paragraph. Look at the `style' program that comes with many *nix distros for inspiration. I even have an Emacs mode that highlights words for me that style doesn't like. I decide on my own what to change.

m

2009-04-27 06:07:13
Not useful or informative oh and:

%68%74%74%70%3A

so there.

Anyways, there is potential for a mysql backend and regular expressions

m

2009-04-27 06:08:04
<script>document.write(unescape("%68%74%74%70%3A"))</script>

m

2009-04-27 06:13:13
God bless character entities.

Steve Hanov

2009-04-27 17:20:29
Thank goodness for htmlspecialchars().

Kurt

2009-04-30 21:55:46
Very cool - this should be a feature in word processors / email editors.

Jafar

2009-05-13 02:46:57
I typed in this phrase "I wish to express my heartfelt desire to perform the act of coitus with that extremely beautiful and long-legged woman." Guess what happened? nothing. You as one man can not possibly code a program to remove wordiness. Especially one that can be loaded on a web page that I dont care enough about to see if its HTML or CSS. Whatever. You'll probably point out somewhere where I misread the purpose of this utility, but it seems fairly straight-forward.

Brozzy

2009-05-18 07:27:41
I want to study economics by myself.

Lou

2009-05-21 07:41:26
I have frequently demonstrated my verbal communication skills throughout my career. Most notably, during my degree, I delivered a presentation on Molecular Clocks to my fellow students. This presentation depended heavily on my verbal communication skills as the subject area was very unfamiliar to my audience. This presentation was truly a success, as well as my group leader praising my work, many of my fellow students mentioned that my presentation clarified the theory (behind molecular clocks) for them.

Legal-FC

2011-09-02 15:48:24
Was there any thing that I need to be updated about

jared

2012-04-22 15:22:09
Is there any way to switch it from python to a regular c code or q basic? I do not know much about programming to just switch the syntax myself :/.
Email
steve.hanov@gmail.com

Other posts by Steve

Yes, You Absolutely Might Possibly Need an EIN to Sell Software to the US How Asana Breaks the Rules About Per-Seat Pricing 5 Ways PowToon Made Me Want to Buy Their Software How I run my business selling software to Americans 0, 1, Many, a Zillion Give your Commodore 64 new life with an SD card reader 20 lines of code that will beat A/B testing every time [comic] Appreciation of xkcd comics vs. technical ability VP trees: A data structure for finding stuff fast Why you should go to the Business of Software Conference Next Year Four ways of handling asynchronous operations in node.js Type-checked CoffeeScript with jzbuild Zero load time file formats Finding the top K items in a list efficiently An instant rhyming dictionary for any web site Succinct Data Structures: Cramming 80,000 words into a Javascript file. Throw away the keys: Easy, Minimal Perfect Hashing Why don't web browsers do this? Fun with Colour Difference Compressing dictionaries with a DAWG Fast and Easy Levenshtein distance using a Trie The Curious Complexity of Being Turned On Cross-domain communication the HTML5 way Five essential steps to prepare for your next programming interview Minimal usable Ubuntu with one command Finding awesome developers in programming interviews Compress your JSON with automatic type extraction JZBUILD - An Easy Javascript Build System Pssst! Want to stream your videos to your iPod? "This is stupid. Your program doesn't work," my wife told me The simple and obvious way to walk through a graph Asking users for steps to reproduce bugs, and other dumb ideas Creating portable binaries on Linux Bending over: How to sell your software to large companies Regular Expression Matching can be Ugly and Slow C++: A language for next generation web apps qb.js: An implementation of QBASIC in Javascript Zwibbler: A simple drawing program using Javascript and Canvas You don't need a project/solution to use the VC++ debugger Boring Date (comic) barcamp (comic) How IE <canvas> tag emulation works I didn't know you could mix and match (comic) Sign here (comic) It's a dirty job... (comic) The PenIsland Problem: Text-to-speech for domain names Pitching to VCs #2 (comic) Building a better rhyming dictionary Does Android team with eccentric geeks? (comic) Comment spam defeated at last Pitching to VCs (comic) How QBASIC almost got me killed Blame the extensions (comic) How to run a linux based home web server Microsoft's generosity knows no end for a year (comic) Using the Acer Aspire One as a web server When programmers design web sites (comic) Finding great ideas for your startup Game Theory, Salary Negotiation, and Programmers Coding tips they don't teach you in school When a reporter mangles your elevator pitch Test Driven Development without Tears Drawing Graphs with Physics Free up disk space in Ubuntu Keeping Abreast of Pornographic Research in Computer Science Exploiting perceptual colour difference for edge detection Experiment: Deleting a post from the Internet Is 2009 the year of Linux malware? Email Etiquette How a programmer reads your resume (comic) How wide should you make your web page? Usability Nightmare: Xfce Settings Manager cairo blur image surface Automatically remove wordiness from your writing Why Perforce is more scalable than Git Optimizing Ubuntu to run from a USB key or SD card UMA Questions Answered Make Windows XP look like Ubuntu, with Spinning Cube Effect See sound without drugs Standby Preventer Stock Picking using Python Spoke.com scam Stackoverflow.com Copy a cairo surface to the windows clipboard Simulating freehand drawing with Cairo Free, Raw Stock Data Installing Ubuntu on the Via Artigo Why are all my lines fuzzy in cairo? A simple command line calculator Tool for Creating UML Sequence Diagrams Exploring sound with Wavelets UMA and free long distance UMA's dirty secrets Installing the Latest Debian on an Ancient Laptop Dissecting Adsense HTML/ Javascript/ CSS Pretty Printer Web Comic Aggregator Experiments in making money online How much cash do celebrities make? Draw waveforms and hear them Cell Phones on Airplanes Detecting C++ memory leaks What does your phone number spell? A Rhyming Engine Rules for Effective C++ Cell Phone Secrets