How to run a technology community

This has come up with several of the companies I’ve been advising over the past few months, so I thought I’d lay out a few of my rules and tips for how to manage a public technical support forum and build a technical community. My thoughts in this area come from twenty years of managing online communities from kitchen table hobby BBSes to tiny startups, to eBay and Yahoo! technical developer communities, to the half-dozen consulting customers I am working with today.

To my mind, the most important rule is that there should be one person in your organization who is responsible for the health of your community. We call this role the "community manager". It doesn’t have to be a full-time job, particularly if you’re a startup or an open-source project, but once your community starts numbering in the thousands of active users, it’s time to start thinking about hiring or outsourcing the management of your community.

The community manager is responsible for the health of the community. This means taking whatever steps are necessary to grow the community, making sure that the community is in alignment with the goals of the business or project, and helping to put out fires when they occur. It also entails the compilation and dissemination of metrics pertaining to the community’s health. Ideally, the community manager shares these metrics with the entire company (and, in some cases, with the community itself). The old business adage "you make what you measure" is at work here — if you are serious about building a community around your product or company and you aren’t sharing your community metrics with your entire team on a regular basis, you only have yourself to blame if the community turns out to be tepid.

The community manager’s report should contain metrics as well as anecdotal information about what’s going on in the forums. If three people post about the same bug in the forums on the same day and nobody from your engineering organization responds, it’s the community manager’s job to escalate that until the problem is resolved.

These days, the community manager is the voice of the company in the community. She’s typically used to convey announcements and news in a way that a spokesperson or public relations person might have done in the past. Here is where an English major with technical chops comes in handy.

Everybody on your team should participate in your community. (At the same time, it’s important that you have one and only one community manager — if everybody’s in charge, then nobody’s in charge.) At some companies I’ve worked at, people had to go through all kinds of hurdles to get permission to post to the forums. This is small-minded; it suggests that you mistrust or have not adequately trained your team. If you have an online forum, then everybody should be encouraged to post to it, particularly people who work for you.

There are a bunch of tactical things to making a community forum work. When we developed an XML-based message board product back in 1999, people thought it was this crazy exotic thing and we had to explain the benefits of XML for customization and syndication over and over again. Today RSSified message boards are de rigeur. They’re the only way I can keep up with the literally hundreds of things I need to read each day. No technology community should be without it. Use the standard RSS icon, make sure your forum home page and each individual topic page has RSS autodiscovery meta tags, and make sure they work in the most popular feed readers (which at the moment happen to be Bloglines, My Yahoo!, Google Reader, NewsGator Online, and Netvibes).

Search engine optimization isn’t something that should be applied only to your marketing web site, it should apply to your community too. At the very least, if the topic of a discussion doesn’t appear in the page title (and preferably in the URL too), dump your community software and get something better.

If you’re a commercial software vendor, make sure that no question in the forum goes unresponded to for more than a day or so. (Your community manager can help with this, although it’s ideal if you have an automated way of doing this.) If paid support happens to be a part of your business model, you may not want to respond that quickly in your forums, which is fine — instead, make it easy for people who post questions in your forums to get priority paid support as an alternative to waiting around for an answer in the community, and manage your community’s expectations regarding the way you expect community-based support to work.

Give recognition to your contributors — they’re helping to build your platform, in many cases free of charge. Some companies resort to special programs (like the Microsoft MVP program) to recognize prominent community contributors, which is fine, but I much prefer engaging in conversations and building relationships with members of the community as a way to incent and recognize them (just saying "thanks for posting that" goes a long way). In many ways, creating a formal recognition program for people is actually easier than having these conversations (since you only have to do the heavy lifting once), which is, I think, why companies gravitate to it. But having conversations is the real money shot here, and if you’re not making time to have these conversations you’re missing out on tons of valuable information.

Your community manager can help engage with prominent contributors, but this should also be something that everybody in your organization should feel empowered to do.

What is a Platform Business?

I was dusting off the Platform Associates web site this afternoon and I ran across this. It’s sort of a manifesto for what I wanted to do with the consultancy. Normally when I re-read this kind of writing six months later it looks hackneyed to me, but I think it pretty well captures what I was going for:

The term "platform" is used in a variety of contexts. Early on, it was often a synonym for "operating system," but today it’s used to describe a variety of scenarios.

Platform businesses create an environment of promiscuous integration as a way to
accelerate operations, get closer to customers and partners, unlock innovation,
and discover efficiencies.

Platform businesses have a number of attributes in common. These include:

  • Platforms are open. A "proprietary platform" isn’t.
  • Platforms can be built upon.
  • No one should have to ask you permission or pay you money to start building on your platform (although platforms can ultimately be both commercial and non-commercial).
  • Platforms attract communities of builders. To thrive, these communities should be managed and nurtured.
  • Building a community around your platform enables you to build your business more effectively with the enthusiastic help of customers, suppliers and partners.
  • Platforms scale efficiently. Self-service access and low barriers to entry are a cornerstone of this.
  • Platforms do not discriminate between small and large builders. Some platforms enable small builders to compete on a level playing field and disrupt incumbent businesses.
  • A platform is a two-way contract between the platform provider and the builders that utilize the platform.
  • Platforms can be managed in a way that encourages positive outcomes for the Platform business as well as customers and builders.
  • Platforms can facilitate unexpected outcomes. This is usually a good thing, if it’s managed properly.

A Thriving Developer Community is a Competitive Differentiator

Link: One Company’s Search For The Perfect Open Source Software – InformationWeek

H&R Block wanted a flexible, easy- to-use document management system to capture clients’ tax documents and move them digitally to its tax preparers’ offices. It considered [closed-source] products, such as FileNet and Documentum. But H&R Block CIO Marc West eventually directed the team to focus on open source options, since the cost of putting commercial options in 13,000 fields offices wouldn’t fly. That left about 300 open source content management packages to choose from, with names like Alfresco, Drupal, JackRabbit, and Joomla.

"The first thing I do
is go out to the community pages," Ginn says. "How many active members
are there, how many [discussion] threads? It tells me whether the
community is thriving."

He also checks for how many developers are involved and how frequently
the project puts out releases. He watches how effectively bugs are
dealt with and inserts his own questions to gauge the caliber of
response.

Terrific worm’s-eye view of how a corporate IT manager evaluates an (open source!) ISV.

Box.net Web Services API Released!

From our pals at Box.net comes a most excellent web services API that developers can use to add storage and file sharing to their applications or web sites.

I’m excited about this launch since I’ve been working with the Box.net team to help provide a terrific experience for developers. It’s terrific that the product has finally decloaked and we can talk about it. Great job, guys!

A Web Services API for Approver.com

I’m very excited to announce that we released the first set of Web services APIs for Approver.com this week. These APIs give you the ability to retrieve information about document status on Approver.com, including the documents you need to approve and the list of a document’s reviewers. More Web services — including read/write calls that enable you to create documents and invite reviewers programmatically — will be along soon.

If you’re a developer and you want to play with our APIs, there are three steps:

Using the Web service APIs is free for noncommercial use. The calls themselves are RESTful (meaning you give us a URL and we give you some XML back) so they should work with any programming language and platform. We have code examples in C# for now but we’re going to see what we can do to add more later.

I should mention that we are working on a paid referral program for Approver in which we’ll pay you if you refer new users to the site who then convert into paid users. This will eventually be an open program, but as with the Web services APIs, we want to make sure we get all the details right, so for now, if you’re interested and you have a web site that generates traffic that you think might be complimentary to the Approver.com experience, drop us a line on the feedback form.

Yahoo Launches Third-Party Authentication for Developers

If you saw my presentation at O’Reilly Emerging Tech way back in March you might remember that I pre-announced a few products, including a Yahoo! Photos API and some others. At that time we also started discussing a new authentication product for developers that would enable users to access their Yahoo! data through through third party applications, starting with Photos and then hopefully extending to others in time.

We’d originally expected to see this product shortly after I made the announcement, but for one reason or another the release got delayed, and I left Yahoo before we were able to make it generally available. So I was happy to see this morning Dan announced that Browser-Based Auth for Yahoo! Web Services has been released. Good job, guys.

An authentication system for a web services platform is a decidedly un-sexy piece of plumbing, but it’s vital if you want to have a read-write platform that keeps the user in control of their authentication credentials. (One advantage of this scheme is that the user doesn’t have to share their password with a third party developer. Another advantage is that the user can shut off the third party application’s access to their data at any time.) This will enable all kinds of fun new applications, particularly if other Yahoo! properties adopt it for their read/write APIs.

Browser-Based Authentication was one of the most challenging product initiatives I drove when I ran the developer network team at Yahoo! — there were an unbelievable number of moving parts, people to coordinate and risks to consider, not a lot of fortune and glory for the many people who worked on it, and lots of questions as to whether it should even get done in the first place (even though eBay, Flickr and others have had similar authentication schemes for their third party developers for years). So it’s terrific that this is seeing the light of day.

The work I’ve done with platform authentication systems at eBay, Yahoo and elsewhere is factoring into my consulting work today. It’s also touching Approver.com; as I’ve discussed on the Approver product blog, we’re working on an Approver.com API which is coming along nicely. Because everything that Approver does requires authentication, we’re having to do our authentication scheme for third-party developers before we do anything else. We will hopefully be able to share more about this in the next few weeks.

Our Kids’ Video Player is an “Open Platform”

Link: WSJ.com – Disney Courts ‘Tweens With Video, Music Player.

Priced at $99, the Mix Max is set to hit stores in late October, say Disney officials. The device has a 2.2-inch color screen and comes with enough memory to hold six hours of video or about 240 songs. Disney hopes to court kids and parents by keeping the price well below what it would cost to buy a video iPod.

While it is possible to download music and videos from sites such as Yahoo and Napster onto the device, Disney also will sell in stores its own movies on postage-stamp-sized memory cards that can be inserted in the Mix Max.

In one significant departure from the recent industry norm, the Mix Max technology is open to anyone who might want to create content for it. "There’s nothing tying it to Disney," says Chris Heatherly, global vice president of Disney global electronics. "We intentionally left the platform open because we knew kids would want other video material."

Very smart — this price point and the fact that the system is open will make this a no-brainer purchase for our little video-watcher this December.