We encourage employees to actively keep blogs about their achievements, discoveries, interests, and ideas. The biggest concern with putting up an article is that once it's up there it's there for the world to see. Do you express yourself properly in blog posts?
This set of rules aims to help you efficiently write clear, effective blogging articles. In some cases, you might be interested in seeing our Rules to Better Technical Documentation for comments on how best to express your technical problems.
When blogging on a large topic, you have 2 options:
- Option 1: Write a very long blog post
- Option 2: Write a series of shorter blog posts (Recommended)
To help understand why option 2 is recommended, let's break it down into pros and cons.
A blog is still a website that you want people to visit, so it’s important to consider the User Interface (UI) and the User Experience (UX).
The RSS or 'subscribe' button is a place on your blog that alow visitors to easily receive your blog's updates.
If you find yourself developing a decision process to make a choice, that process should be documented as a standard. If want to explain further how you did something to solve a specific problem, you should record that in a blog post.
Any time you find yourself writing a long email, ask yourself whether it should be recorded in rule or a blog post, rather than just in an email. This way everyone who might find it useful can see it, not just the people on the email thread.
Every time someone does a talk/records a video, it helps spread the word about your content if your video keeps getting shared.
If you have a blog, a good idea is to add a simple post to tag your new video. It gets double Google juice if you:- Have a good description of your video on YouTube; and
- Your video is linked in a blog post using popular keywords for the content/topic you have recorded about.
Whether you are converting an email to a blog post or writing it from scratch, always invite and instruct discussion.
It is easy to think that "Content is King"; it is a well-known quote from an article by Bill Gates in 1996. But incorrect content is not very useful, so we think that " factual content is king".
In this age of misinformation, it is easy to get swept up in online hype and share stories/posts that everyone else seems to be sharing. This, however, can get us into trouble as it can perpetuate said misinformation and impact how a situation is viewed by the general populace.
It’s important to not only check that what you share on social media is correct, but also, that your opinions are based on fact.
If someone gives you feedback and you think it is worth incorporating into the content, you should always name them at the top of your blog post. This makes them feel good and gives your post more credibility.
Technical people need a little bit of a free leash in order to be creative. This will benefit the company they work for by demonstrating how technical your staff are, by driving more traffic to your site, and making your staff happier.
- Do you split large topics into multiple blog posts?
- Do you consider the design on your blog?
- Do you have a 'subscribe' button on your blog? (aka RSS)
- Do you document what you are doing in rules/blog posts?
- Do you blog every time you publish a video?
- Do you know how to encourage blog comments?
- Do you know that 'Factual Content is King'?
- Do you check your facts before posting online?
- Do you acknowledge people who give you feedback?
- Do you know to allow employees to post to their personal blog?
- Do you polish blog posts after hours?
- Do you know to make what you can make public?
- Do you know to tip, not rant?
- Do you know to update a blog?
- Do you post all useful internal emails to the company blog?
- Do you add a prefix on blog posts titles?
- Do you clearly highlight video content?
- Do you avoid the term "emotional"?
- Do you know how to share a touch of code?
- Searchability - Do you transcribe your videos?
- Do you add a featured image to your blog post?
- Do you know where to find images for your blog?
- Content - Do you share every blog post?
- Do you give thanks for valuable content?
- Do you promote your colleagues?
- Technical - Do you tag external URLs with rel=”nofollow”?