What does blogging for Google even mean?

The easiest demonstration is to look at a screenshot from the Google Console Insights report I was sent last week. This section of the report shows the most used search terms that result in someone ending up on my blog.

As you can see, 4 of the top 5 search terms are for error messages, and very specific ones at that. I don’t think I ever mentioned these blog posts on social media because they’re just not that interesting to a general audience.

They are useful to a very specific audience though: people who have come across those error messages and don’t know what to do next!

When I get an error message that I don’t understand, the first thing that I do is paste it into Google to see if someone else has come across it. If there’s already a blog post or a StackOverflow answer that covers the exact same problem I’ll probably move on, safe in the knowledge that this error message is already covered.

I should say that I sometimes find the answer to my problem under a completely different search term, perhaps buried in the comments of a GitHub issue. In that case I might still write a post and link to the place where I found the answer.

Hopefully you’re now slightly curious about writing about exceptions or error messages and in this section we’re going to learn what these posts should contain. They do tend to be quite short and I follow rougly this template:

The title of the post should contain the error message and/or the search term that you used/would use if you encountered this problem in future.

Below are some recent examples of posts that I’ve written about error messages:

Notice that none of these posts are all that long - by my calculations the maximum number of written words in any of them is ~300.

So far we’ve covered why you should write about error messages and what should go into a post about error messages, but how do we do it?

There’s certainly a temptation when you come across error messages to try to solve them as quickly as possible and then move on. I would encourage you (and me!) to be a bit more deliberate about it.

I try to keep some sort of scratchpad document open on my computer whenever I’m coding. It could be a Google Doc or an empty text file, it doesn’t matter.

It just needs to be easily accessible so that when you come across an error message, you can paste it into the file. I’d also suggest adding some context around the error message, such as what you were doing when you got it and any search terms that you used when trying to figure it out.

When you (hopefully!) solve the problem, you can then copy/paste the context and the error message to your blogging platform, add in the solution, and you’re done!

Write about error messages! These are some of the easiest blog posts that you’ll ever write and your users will thank you for it 😊

One of those users might even be your future self - I frequently come across my old blog posts when searching for error messages to the point where Google is almost acting like my external brain.