We’ve invested a lot of effort in ensuring that the writing be helpful, engaging, easy to read on any device, and flexible. This guide helps provide the tools to make composing blog posts and long-form educational content as easy as possible.

Goals

With any of our writing, we have three major goals all with purpose of helping the reader regardless of whether they are or intend to be a customer. From the reader’s point of view, our content should help them do three things:

From our point of view as content makers and designers, those points—learn, feel, decide—map to the three primary jobs we need to do:

Notice that none of those points is “sell.” :) Of course it would be wonderful if everyone wanted to use Sifter, but that’s not realistic. There are too many factors at play for Sifter, or any tool, to be perfect for everyone. We want to help them make the best decision for them, not for us.

Naturally some of our writing will specifically be about Sifter, and that’s alright. However, where possible, we should strive to make the posts educational regardless of whether the reader uses Sifter. For example, a new feature announcement or company news won’t necessarily be educational. However, if we’re writing about the design of a feature, we should treat that as a larger educational opportunity rather than merely an opportunity to teach about Sifter.

Tone/Voice

The primary goal for the tone and style is to write copy that is short, friendly, and genuinely helpful. We want to be informative but not didactic. Opinions are acceptable, but you should never be dogmatic about it.

Ultimately, remember that you’re talking to diverse audience in a dizzying array of different scenarios of team size, technology stack, location, etc. We’re presenting our thoughts, but it’s impossible to make them perfect for everyone. So don’t try. Better to write a focused article that helps a small group a lot than a broad article that’s too abstract to help anyone.

Structure & Length

In general, we want to keep blog posts concise. (About 500-800 words.) This does two things. First, it makes the content more digestible and less overwhelming. Second, it helps each post stay focused and on topic. If something needs to be longer, it would likely be better off as a dedicated educational page elsewhere on the site.