Boilerplate Instructions, Bane of Modern Software


I bought a new theme to install for a client this week.

Normally, installing a theme is simple. Select theme, upload, install, done.

Unless the theme maker has decided to deviate from the standard protocols that we all know and love and which we have been happily following for years.

At that point all bets are off. Basically, the only choice now is to open their documentation and start reading their instructions line by line and following every micro-directive verbatim.

That is, assuming they have actually bothered to tell you what each little step is.

But no, in this case they just told me in generic terms to do what I had already done; the same thing that had already failed miserably.

“Go to the Appearances menu and upload your new theme.” they say.

Boilerplate instructions.


Now what?

Oh, yeah, figure it out for myself!

Talk about lazy and thoughtless. Not a great combo!

They didn’t even bother to test their own theme and discover that,

…Oh wait, we packaged it in such a way that the theme is named something completely different from what most people will expect and it’s also buried in a series of subfolders along with another thing that’s called a child theme and you’re just supposed to know that you don’t actually have to use the child theme, but if you do, you’ll need to install that first and then…


Here’s the opportunity…

Test your instructions exhaustively and triple-check your documentation!

Having clear, excellent instructions that actually work is just as important as having a great product.

Junk instructions could cause someone to mistake your product for junk since it’s likely they’ll fail to get it to work as intended.

And then they might just ask for a refund.

Aha, instructions just became as valuable as the product itself!

Funny how that works.


Photo by Seth Anderson – CC Attribution-ShareAlike 2.0


Some Answers to Your Hosting Questions

When it’s time to move to a new hosting company, many questions inevitably arise. In this post I hope to answer a few of those questions, especially the more frequently asked and important ones.

Which Hosting Plan Should I Choose?

The hosting plan you choose will mostly be dependent upon the amount of storage space you need and how much processor power your website requires. Storage space is determined by a combination of both your website files and all of your e-mail in all of your e-mail accounts. So, if your website takes up 1 GB of space, and you have three e-mail accounts each using around 300 MB of space, you would need at least 2 GB of storage space in the new hosting account.

However, since e-mail accounts are always growing larger and websites that are active are also growing larger, you need to accommodate that growth by purchasing at least twice as much storage space as you are currently using, preferably a little more.

Most folks will be able to get away with 5 GB of total storage space in the beginning. (This is the Standard Plan at Liquid Web.) It doesn’t hurt to have at least 10 GB of space if you know that you get a large volume of e-mail and you plan to be adding lots of photographs and videos to your website which aren’t hosted on a separate server.

How Much Space Does My Account Use?

[Read more…]