Developers And Documentation

October 10, 2018 ,,Comments Off on 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, 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?”


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
©2023 FeverBee Limited, Apartment 2410, 251 Southwark Bridge Road, London SE1 6FN England 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.


Level Price  
ALL COURSES $750.00 per Month.
Community Development Program $1,100.00 per Month.
Director of Community $8,770.00 per Month.
Free Trial - Accelerator Program Free.
Community Accelerator (founding members) [annually] $250.00 per Year.
Community Accelerator and FeverBee Intelligence [monthly] $45.00 per Month.
Community Accelerator and FeverBee Intelligence [annually] $450.00 per Year.
Full Community Upgrade (Large Enterprise Only) [monthly] $750.00 per Month.
Full Community Upgrade (Large Enterprise Only) [annually] $7,600.00 per Year.