DANSE

Survey Results
[ Main ]    [ Results as Table [?] ]    [ Export Results to CSV [?] ]
Results for Survey #17: Software Documentation Survey
Questions marked with a [*] were required.

[?]

Survey Time Stats
Average Completion Time: 5min 18sec (Min: 1min 16sec, Max: 37min 34sec)
Average Time before Quit: 0min 26sec
  Welcome to a short survey about media and formats for software
documentation. Please click "Next Page" below to begin.
  1.  [*] Please designate your experience in software development.
A 1 would be none, whereas a 10 would be a professional level
where you could get a job doing code development in San Jose,
Calif.
1 - 1 4.35%  4.35%
2 - 1 4.35%  4.35%
3 - 4 17.39%  17.39%
4 - 0 0.00%  0.00%
5 - 3 13.04%  13.04%
6 - 1 4.35%  4.35%
7 - 3 13.04%  13.04%
8 - 2 8.70%  8.70%
9 - 4 17.39%  17.39%
10 - 3 13.04%  13.04%
more than 10 - 1 4.35%  4.35%
Total Answers - 23
  For software that you are learning to use, what have you found
to be the most useful form of documentation?
  2.  on-line help from the program itself
Like a lot - 18 81.82%  81.82%
Borderline - 3 13.64%  13.64%
Dislike - 1 4.55%  4.55%
Total Answers - 22
  3.  an associated web site
Like a lot - 14 63.64%  63.64%
Borderline - 6 27.27%  27.27%
Dislike - 2 9.09%  9.09%
Total Answers - 22
  4.  a software manual in pdf or hardcopy form
Like a lot - 12 54.55%  54.55%
Borderline - 9 40.91%  40.91%
Dislike - 1 4.55%  4.55%
Total Answers - 22
  5.  textbook published professionally
Like a lot - 7 31.82%  31.82%
Borderline - 12 54.55%  54.55%
Dislike - 3 13.64%  13.64%
Total Answers - 22
  For software that you will learn to use in the future, what do you
think will be the most useful form of documentation?
  6.  on-line help from the program itself
Like a lot - 18 81.82%  81.82%
Borderline - 3 13.64%  13.64%
Dislike - 1 4.55%  4.55%
Total Answers - 22
  7.  an associated web site
Like a lot - 18 81.82%  81.82%
Borderline - 4 18.18%  18.18%
Dislike - 0 0.00%  0.00%
Total Answers - 22
  8.  a software manual in pdf or hardcopy form
Like a lot - 13 59.09%  59.09%
Borderline - 7 31.82%  31.82%
Dislike - 2 9.09%  9.09%
Total Answers - 22
  9.  textbook published professionally
Like a lot - 9 40.91%  40.91%
Borderline - 7 31.82%  31.82%
Dislike - 6 27.27%  27.27%
Total Answers - 22
  10.  Do you think the type of medium affects the quality of the
documentation itself?
Definitely Yes - 7 31.82%  31.82%
Cautiously Yes - 9 40.91%  40.91%
Maybe - 3 13.64%  13.64%
Probably Not - 3 13.64%  13.64%
Definitely Not - 0 0.00%  0.00%
Total Answers - 22
  11.  Do you have other suggestions for the type of media you would
like to see for the documentation of software?
Total Answers - 2
[ View Answers ]
  For the science and software of inelastic neutron scattering, we
are composing a textbook that is now in excess of 200 pages.
How do you think we should make this accessible?

  12.  suggestions?
Total Answers - 2
[ View Answers ]
  13.  online, with menu-driven access to different sections (probably
50 sections)
Like a lot - 16 72.73%  72.73%
Borderline - 6 27.27%  27.27%
Dislike - 0 0.00%  0.00%
Total Answers - 22
  14.  large compiled document in pdf format that could be printed
Like a lot - 13 59.09%  59.09%
Borderline - 6 27.27%  27.27%
Dislike - 3 13.64%  13.64%
Total Answers - 22
  15.  professionally published (estimated price $80-120)
Like a lot - 5 23.81%  23.81%
Borderline - 4 19.05%  19.05%
Dislike - 12 57.14%  57.14%
Total Answers - 21
  16.  If you have used any of the software tutorials or FAQ on the
DANSE Mediawiki, could you please comment on how these
could be made better?
Total Answers - 5
[ View Answers ]
  This completes the survey. You will go next to the results from
all responses received so far. Thank you!
[ Main ]