Search results

How Do Blogs and Wikis Fit Together?

by Tom Johnson on Sep 8, 2009
categories: blogging technical-writingwikis

Although many people put blogs and wikis in the same social media category, blogs and wikis are actually quite different. Blogs are individually authored mini-magazines or journals where one author (or sometimes a small authoring group) crank out article after article (or entry after entry) usually with a common theme. After each article is published, the article is considered done and the author moves on to newer pastures, always hunting for the next story, formulating the next insight, thinking about the next post. Readers can comment and subscribe by RSS.

Wikis, on the other hand, are a platform for groups to collaborate on an information project, such as documentation, technical specs, or other reference material (e.g., Wikipedia). One author isn't just cranking out all the information. Multiple authors are contributing chunks and pieces, linking from one page to another, making edits on each other's content, diving deeper where necessary, and moving toward the idea of a more complete information product. Wikis are rarely ever done. They are successful only as much as they tap into the collective intelligence of a group.

How exactly do these two formats fit together? In Conversation and Community, Anne Gentle says that the blog can often be a conversation starter, the medium that opens up communication among people. Your blog can attract outsiders and draw them in to participate on a wiki or other involvement.

Seeing how these two formats and activities fit together provided an Aha! type of moment for me last week. We have a community projects wiki where a lot of developers, QA engineers, and others interact on a technical level, either compiling requirements, designs, or other details about the projects they're building. The site also has a blog component, but the blog doesn't always address the existing projects. In fact, the blog mainly consists of random IT topics written by people in our department.

I realized (not that it's really much of an insight) that in this situation, the blog should act as a companion to the wiki. While the wiki has project details and other specs, it's not the motivational piece. It doesn't build trust, inspire people to join the community, or even communicate that much to those outside of the layers of its structure. Just as a charter or project requirements documents rarely inspires anyone to volunteer for the project, the same might be said of wikis. But that's not the wiki's job. It's the blog's job. The blog serves as the human-focused news stream for sharing announcements, insights, developments, stories, and other details about the projects going on in the wiki. They're a perfect fit, and one fuels the other.

About Tom Johnson

Tom Johnson

I'm an API technical writer based in the Seattle area. On this blog, I write about topics related to technical writing and communication — such as software documentation, API documentation, AI, information architecture, content strategy, writing processes, plain language, tech comm careers, and more. Check out my API documentation course if you're looking for more info about documenting APIs. Or see my posts on AI and AI course section for more on the latest in AI and tech comm.

If you're a technical writer and want to keep on top of the latest trends in the tech comm, be sure to subscribe to email updates below. You can also learn more about me or contact me. Finally, note that the opinions I express on my blog are my own points of view, not that of my employer.