Click here to Skip to main content
14,577,604 members

Survey Results

What's important when reading about a company's (dev related) product or service?

Survey period: 23 Sep 2019 to 30 Sep 2019

Maybe you've bought a product, maybe you're thinking of buying it. Which bits are important?

OptionVotes% 
A page explaining exactly what the product does and *why* one would use it17368.65
Full online documentation17368.65
Quick “Getting Started” section18272.22
Advanced tutorials12248.41
Example implementations with source code18573.41
Search or index page to help find stuff8634.13
Discussion forums or Question/answer area9738.49
Live chat with a Real Human207.94
A way to contact a sales person or support engineer directly3915.48
A company blog to show what aspects of the product they are focused on right now2911.51
Respondents were allowed to choose more than one answer; totals may not add up to 100%

View optional text answers (6 answers)


 
GeneralTechnical documentation is not a single "media" Pin
Mario Z25-Sep-19 5:18
professionalMario Z25-Sep-19 5:18 
First, I'm not sure why the first option got so much votes ("... page explaining product ..."), in this context I don't think it makes much sense.

You see I wouldn't expect that some developer will just randomly stumble upon an overview page of some product and then have to read what the product is all about.
Instead I think it's more likely that he will be searching for a solution to some problem that he has and then find the product, perhaps it will lead him to a page that explain how to solve that exact problem.

Anyway, I think that beside the first option, this pool pretty much shows what I expected. The type of resource that some developer will want will depend on the product, but also on the person.

There are few types of resources and each could be preferred by different developers. It could be goal oriented (some quick sections like "how to" and "getting started"), learning oriented (like "basic and advance tutorials" and "lessons"), information oriented (like "complete reference" and "full documentation"), etc.

So, if you're not sure what kind of developers your product will most likely be targeting, then you'll basically need every type of documentation and each of them will require a distinct style of writing.
GeneralUp to date and complete documentation Pin
RJOberg24-Sep-19 8:52
professionalRJOberg24-Sep-19 8:52 
GeneralHow many people are using it? Pin
Sander Rossel23-Sep-19 5:10
professionalSander Rossel23-Sep-19 5:10 
GeneralWhat I DON'T want PinPopular
Tom Corbett Space Cadet23-Sep-19 5:05
professionalTom Corbett Space Cadet23-Sep-19 5:05 
GeneralWhy, what, how Pin
den2k8823-Sep-19 4:53
professionalden2k8823-Sep-19 4:53 
GeneralSomehow the weekly questions change in content and context... Pin
Mike Barthold23-Sep-19 2:19
professionalMike Barthold23-Sep-19 2:19 
GeneralRe: Somehow the weekly questions change in content and context... Pin
Slacker00723-Sep-19 2:45
professionalSlacker00723-Sep-19 2:45 
GeneralRe: Somehow the weekly questions change in content and context... Pin
den2k8823-Sep-19 4:57
professionalden2k8823-Sep-19 4:57 
GeneralMuch Like Purchasing Anything Else Pin
W Balboos, GHB23-Sep-19 2:16
mveW Balboos, GHB23-Sep-19 2:16 
GeneralI'm old school Pin
Marc Clifton23-Sep-19 2:12
mvaMarc Clifton23-Sep-19 2:12 
GeneralMissing option Pin
Shameel23-Sep-19 1:58
professionalShameel23-Sep-19 1:58 
GeneralRe: Missing option Pin
den2k8823-Sep-19 4:55
professionalden2k8823-Sep-19 4:55 
GeneralExample projects vs tutorials Pin
Viktor Kovács22-Sep-19 21:48
MemberViktor Kovács22-Sep-19 21:48 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.