Developers And Documentation

Last year we reviewed some research on a developer community.

A somewhat crude paraphrasing would go something like this:

Q. “What would you like in the community?”
A. “Great documentation!”

Q. “What about better discussions, expert interviews, live chatting with product engineers?”
A. “No, we just want great documentation”

Q. “Do you think we should have a Slack channel?”
A. “We don’t care, we just want great documentation”

Q. “Would you be interested in publishing a blog post sharing your expertise?”
A. “No, I.want.to.see.great.documentation please”

Q. “If you had to choose between a blog post, expert interview, or a live chat…which would be your favourite?”
A. “Good documentation”

It’s obvious the community manager isn’t listening. S/he is looking for anything that validates the kind of community they already plan to build. No-one is going to win here.

A far better set of questions would go:

“Documentation? Great what kind of documentation do you most need?”

“What format do you like documentation in?”

“Would you like to edit it? Would you be interested in other developers adding their notes/comments on it?”

“How would you like to be notified of updates by documentation?”

“If we allow others to add their notes/make updates, should this be hand-selected or should we have a review process?”

Etc….

Now you can start shaping exactly the kind of community members want.

It might not even have a discussion area. It might be a wiki, a series of updated guides people can clip notes to or something else entirely.

It’s far harder to listen that we might imagine. Don’t go through a research interview with a set of questions hoping to get an answer that supports what you already want.

Genuinely do the research with an open mind and go where it takes you.

Comments Off
©2018 FeverBee Limited, 1314 New Providence Wharf, London, United Kingdom E14 9PJ FEVERBEE

We’d like you to join us.

We’re a group of community professionals who push each other to the cutting edge of our work. Every day we share our experiences, highlight new expertise, and push one another to become the best community builders we can be.

The day you join, you’ll get access to 1000+ practical tips, dozens of resources, and unlimited access to the top experts in our space. You’ll also get to see how we go about building a community amongst our own audience.

It takes just 30 seconds and doesn’t cost a thing.

CLICK HERE AND JOIN FEVERBEE

Level Price  
ALL COURSES The price for membership is $750.00 per month or $7,200.00 per year
Select
Community Development Program The price for membership is $1,100.00 per month or $10,560.00 per year
Select
Director of Community The price for membership is $8,770.00 per month
Select