Click here to monitor SSC

Tony Davis

Simple-Talk Editor
News, views and good brews

On Writing Blogs

Published Friday, March 19, 2010 11:53 AM

Why are so many blogs about IT so difficult to read? Over at SQLServerCentral.com, we do a special subscription-only newsletter called Database Weekly. Every other week, it is my turn to look through all the blogs, news and events that might be of relevance to people working with databases. We provide the title, with the link, and a short abstract of what you can expect to read. It is a popular service with close to a million subscribers.

You might think that this is a happy and fascinating task. Sometimes, yes. If a blog comes to the point quickly, and says something both interesting and original, then it has our immediate attention. If it backs up what it says with supporting material, then it is more-or-less home and dry, featured in DBW's list. If it also takes trouble over the formatting and presentation, maybe with an illustration or two and any code well-formatted, then we are agog with joy and it is marked as a must-visit destination in our blog roll.

More often, however, a task that should be fun becomes a routine chore, and the effort of trawling so many badly-written blogs is enough to make any conscientious Health & Safety officer whistle through their teeth at the risk to the editor's spiritual and psychological well-being.

And yet, frustratingly, most blogs could be improved very easily. There is, I believe, a simple formula for a successful blog. First, choose a single topic that is reasonably fresh and interesting. Second, get to the point quickly; explain in the first paragraph exactly what the blog is about, and then stay on topic.

In writing the first paragraph, you must picture yourself as a pilot, hearing the smooth roar of the engines as your plane gracefully takes air. Too often, however, the accompanying sound is that of the engine stuttering before the plane veers off the runway into a field, and a wheel falls off. The author meanders around the topic without getting to the point, and takes frequent off-radar diversions to talk about themselves, or the weather, or which friends have recently tagged them. This might work if you're J.D Salinger, or James Joyce, but it doesn't help a technical blog. Sometimes, the writing is so convoluted that we are entirely defeated in our quest to shoehorn its meaning into a simple summary sentence.

Finally, write simply, in plain English, and in a conversational way such that you can read it out loud, and sound natural.

That's it! If you could also avoid any references to The Matrix then this is a bonus but is purely personal preference.

Cheers,

Tony.

Comments

 

BuggyFunBunny said:

"You talkin' to me? You talkin' to me? You talkin' to me? Then who the hell else are you talkin' to? You talkin' to me? Well I'm the only one here. Who the [expurgated] do you think you're talking to?" (apologies to De Niro, of course; but that couldn't be passed up.)

A blog, originally weblog, which originally was defined to be an on-line diary of one's daily thoughts.  As such, the stream of consciousness approach remains prevalent.  What you've described is what is taught to first year journalism students:  "tell 'em what you're going to tell 'em, tell 'em, tell 'em what you've told 'em; and keep at 6th grade level".  But that requires lots more effort, and all but a handful of bloggers don't get paid to spew their brain matter, so view the exercise somewhat self-indulgently (not I, of course).

Finding a theme for a blog is the most difficult part.  The next most difficult is deciding whether to be a news aggregator (perhaps not admitting so; but you've all seen this type where 90% of the text is copied from elsewhere) and prolific, or write original material (either organically from one's head or as reportage) and be far less so.  A mix is usually what happens, just to keep the thing going.  Further, depending on one's itch (and specifically in the database arena; 18th century Russian poetry, less so), original material can require non-trivial amounts of time and money, the latter for hardware/software needed to create that original material, and the former to build the thing which scratches the itch.  All gratis, naturally; unless one's employer supplies the facilities.

Opinion based, as opposed to original material or reportage, blogging is just so much less effort.  Never seen The Matrix, so I won't be making that error.  This entry isn't up to the standard just described. :)


March 19, 2010 1:28 PM
 

timothyawiseman@gmail.com said:

I believe BuggyFunBunny has some excellent points and I cannot agree enough.

But I think there is another factor that he glossed over.  Most technical blogs are written by programmers/administrators and those people as a general demographic have not spent a lot of time developping their interpersonal skills.  They probably have not spent a lot of time learning to communicate with humans in particular.  Also remember that some of them may be using English as a second language.

On thing I have to take a slightly different stance form Tony on is on including personal material.  Blogs are normally informal and I for one prefer them that way.  I do not mind if personal anecdotes or personal references are included, so long as they are kept reasonable in relation to the technical material presented.  I find that a small amount (I cannot overemphasize the small amount) can help the author be more human and differentiate the blog from a random man-page and can even make it easier to read by breaking it up ever so slightly.  
March 19, 2010 3:49 PM
 

Jason Haley said:

Interesting Finds:  March 20, 2010
March 20, 2010 6:29 AM
 

wonderbison said:

Tony

As part of your history I am sure you are aware that many good techies are just that, techies. The art of writing as a whole new skill set. Many techies also have many random, unstructured and tangent provoking thoughts with analogies and idiocyncracies pertinent to them or their culture.

I can see your point of view as an editor and collator but I think you are sometimes trying to put a square peg in a round hole with this particular task. You are taking an already written piece of work and trying to collate it in to something that is useful to your business where as the blogger will have a totally different agenda. This could be to bring "Googlers" to their site for technical expertese, to promote their technological "prowess" or amongst other reasons, simply "brain dump".

Dont get me wrong, a large number of your points are valid and I hate books and blogs that you not only have to think and understand what has been written, but also you have to think and understand how it has been written. There are a number of books sitting next to me here that have a great potential of being an awesome book but its like trying to run through glue. Blogs can be the same.

Blogs are what they are and I think readers will find a blogger with the same coloured sky in their world as their own and off on to the neon pink sunset they will ride.
March 22, 2010 3:52 AM
 

Mike.Cabolet said:

Dear Tony,
When you ask yourself why blogs sometime so difficult to read, you and the other who give response ignore the fact that writing is a skill. Many people these days know to write things down but that does not make them a novel writer.
The idea of timothyawiseman@gmail.com that bloggers are persons who have no strong communicative skills can help to make writing bad but is not the reason. As many people who do have good communicative skills are also writing down horrible language where readers can’t find any beginning and end on the story told. Also, many very good writers lack the ability to have a normal conversation with other people.
Like I mentioned earlier, writing is a skill that some have and most have not. You can learn it by writing more often. I believe  that most blogger who read back there works 10 years after also will see what other readers can see in one moment. But as long as there contribution has elements of interest for their readers the blog will be read. If it is too annoying from style and content, these bloggers will disappear from the active blogger community but at least they give it a try to give others a gimp of their writing skills.
March 22, 2010 6:33 AM
 

Phil Factor said:

I don't buy into the idea that we are doomed by our geekyness to produce rambling and unintelligible writing that fails to capture the reader's interest. Other professions include good communication skills in the basic training, and I've always wondered why we don't.  I once asked an eminent lecturer in computer Science at Cambridge and in reply he just mumbled techno-babble whilst avoiding my gaze. It is instructive to look at the way that Art Schools train artists to be able to communicate the thinking behind their work. Artists acknowledge that to be commercially successful, they have to be able to explain the thinking behind their work, and the way it should be interpreted: so they make that, and marketing skill, part of their professional training. They can explain what they are doing to any lay person with a fat wallet.

Writing isn't an innate skill, it can be learned as easily as any other. Good English teachers will say that anyone can learn to write well: they don't mean that it comes naturally to anyone with the inclination; it requires practice and training.



March 22, 2010 7:12 AM
 

Jack the DBA said:

Tony,

An interesting editorial and some good comments.  I think one thing that you left out is why a person is blogging.  Are they blogging as personal notes, to demonstrate technical prowess, to provide value to others, or to provide opinion on events in the community.

If a person is using their blog for personal notes (in some cases I've done that) then they are likely less concerned about the quality of writing, but for all the other reasons they at least should be concerned with quality.

I do care and and try to write in an organized manner.  I do find it more difficult to write more highly technical posts because, as BuggyFunBunny said, the time, resources, and effort to produce a highly technical post are much more intensive than an opinion.  If I'm going to spend that much time on a technical post, I'd rather send ti to SQLServerCentral or Simple-Talk where I'll be compensated (maybe not highly) for the time I put into it.
March 22, 2010 7:26 AM
 

JonRobertson said:

I determine the blogs I visit frequently not just by the content, but by the author as well.  There are some blogs that cover content I'd really like to follow, but the author's style (or communication skill) is so different from mine that it just isn't worth my energy or time.

I'm equally critical of emails.  I've worked with people that do not communicate well at all.  Reading their emails is often very painful.  Sometimes, communicating with them in person isn't that pleasant either.

I'm also critical of my own writing.  I re-read every once before sending/submitting.  And then I often find myself re-reading it again later.  My writing is often verbose.  I've finally learned to make my point at the beginning, rather than the end.  This way, if I lose someone half-way, at least they've gotten the meat of the writing.  The remaining side items give more detail that they may or may not care about reading.
March 22, 2010 7:27 AM
 

aleonard763 said:

To quote Morpheus: "The body cannot live without the mind." (I couldn't resist - apologies Tony!)

Your points are valid and I am one of the worst offenders. I appreciate (and share) the intention of most blog authors, which is sharing experience in hopes of helping someone overcome a similar issue.

:{> Andy
March 22, 2010 8:18 AM
 

Matt Cherwin said:

Others have already mentioned it, but I think it bears repeating - there is a disjoin between what you're looking for in a blog and what the blogger is looking to do with his or her blog. Blogging well - writing well in general - is difficult. I agree with the mysterious Mr. Factor that it a skill which can be taught, and one which ought to be, but the fact remains that for many in the technical field, it has not been.

For someone who has no particular training in writing, and who is writing a blog for personal reasons, it isn't (or shouldn't be) surprising that the someone's blog is often poorly written. Of course, if the blogger isn't going to take the time to make his or her posts accessible to the rest of the world via decent writing, one does wonder why he or she bothers to make them accessible to the rest of the world via the web.

On the other hand, if all the blogs were well-written and informative, then there wouldn't be any need for Database Weekly!
March 22, 2010 9:00 AM
 

r_honey said:

Well, I think what Tony says for the most part (well written, laid out and understood, publication-ready articles), reflects what he would like to see in writing as an editor,  rather than a small-time independent blogger, having all sorts of unique and common reasons to write one's blog posts, one considering the blog as his/her own pie of the web, something that belongs, is controlled by and is associated to his/her personality.

Guess how would the blogging world look like if all blogs were same stereotype-dly written.

Blind lifting of content from someone else's blog is disturbing for sure, but that also increases the indexing of the content, and makes sure the person in need is able to access the content from one place or the other. I am not justifying such plagiarism, but it helps content search for sure. So, a little link-back to the original post should justify such copy-paste better.

Was wondering what such a demanding editor would think about my blog!!!
March 22, 2010 11:52 AM
 

BuggyFunBunny said:

@r_honey (and others, perhaps):
Blind lifting of content from someone else's blog is disturbing for sure

Just to clarify, since my post could be interpreted to mean this, I didn't intend to assert that bloggers who aggregate are lifting without attribution, on the contrary, I was referring to the practice of creating a blog post which is predominantly quotes from other sources.  Of the ones I follow, these quotes are from news (broadly speaking) sources, not other bloggers; I don't hang around bloggers who echo and certainly not one I found to plagiarize.
March 22, 2010 1:41 PM
 

hugosheb said:

Well, your points are valid and thanks for the related commentary.
I'd be pleased if you left comments when I slip up, and others would too I suppose. We cannot read your mind either - we are only giving our time for free, so there's only so much criticism that one should dole out on volunteers :) But at the same time, as soon as you speak of a unpopular subject... you're at great risk of turning off some loyal readers. Remember, everyone is entitled to a brain fart.
Nobody edits our stuff but us usually, hence I go back to fix mistakes for several months of corrections and reference additions before switching over to the backup blog on http://dbhive.blogspot.com
Anyone else have specific personal techniques they use to comply with Master Davis' recommendations?
April 12, 2010 10:43 PM
You need to sign in to comment on this blog
<March 2010>
SuMoTuWeThFrSa
28123456
78910111213
14151617181920
21222324252627
28293031123
45678910
How to Kill a Company in One Step or Save it in Three
 The majority of companies that suffer a major data loss subsequently go out of business. David Wesley... Read more...

Migrating from OCS 2007 R2 to Lync: Part 4
 Having migrated the rest of our users and legacy resources across, and start getting ready to... Read more...

Automated Script-generation with Powershell and SMO
 In the first of a series of articles on automating the process of building, modifying and copying SQL... Read more...

Seth Godin: Big in the IT Business
 Seth Godin has transformed our understanding of marketing in IT. He invented the concept of 'permission... Read more...

Using SQL Test Database Unit Testing with TeamCity Continuous Integration
 With database applications, the process of test and integration can be frustratingly slow because so... Read more...