Click here to Skip to main content
15,888,351 members

Survey Results

A user, following obviously incorrect documentation, uses a piece of hardware incorrectly, which triggers a software bug and causes an expensive hardware failure. Who's at fault?

Survey period: 29 Aug 2022 to 5 Sep 2022

OptionVotes% 
The user184.28
The documentation writer for writing incorrect instructions5713.54
The software developer for writing bad code255.94
The hardware manufacturer for making hardware that isn't resilient to, or catches, bad code317.36
The hardware/software integration and system tester for missing the multiple issues4811.40
All of the above20047.51
None of the above. It was an accident194.51
Something else (please comment)235.46



 
General"Fault" is the wrong word Pin
Mark Copenhaver29-Aug-22 7:43
Mark Copenhaver29-Aug-22 7:43 
GeneralRe: "Fault" is the wrong word Pin
Cpichols30-Aug-22 2:12
Cpichols30-Aug-22 2:12 
GeneralThe Programmer / Product Owner Pin
megaadam29-Aug-22 5:51
professionalmegaadam29-Aug-22 5:51 
GeneralNot the User Pin
ronlease29-Aug-22 5:48
professionalronlease29-Aug-22 5:48 
GeneralRe: Not the User Pin
Doug Domeny29-Aug-22 7:46
professionalDoug Domeny29-Aug-22 7:46 
GeneralFor me as a software developer, "The documentation writer" is the safest alternative ... Pin
trønderen29-Aug-22 3:46
trønderen29-Aug-22 3:46 
GeneralRe: For me as a software developer, "The documentation writer" is the safest alternative ... Pin
Cpichols30-Aug-22 2:14
Cpichols30-Aug-22 2:14 
GeneralRe: For me as a software developer, "The documentation writer" is the safest alternative ... Pin
trønderen1-Sep-22 5:57
trønderen1-Sep-22 5:57 
Like, I am a car mechanic, knowing the car best, so I am the one who should teach you how to drive in heavy city traffic.

If you are talking about software maintenance documentation, you may be the best person to write that documentation - although I have seen some outright awful attempts by software guys to write even that sort.

For the end user documentation, you need a domain expert. If the domain is software development - say, you are making development tools for the FOSS community - then you may be domain expert, knowing in detail the problem(s) to be solved, well established work patterns and solutions, the professional terminology (domain specific), etc. etc. If you are a good writer, maybe you are the one. ("Good writer" covers both mastering the language, and the skill to organize the information in proper ways.) If you are writing software to be used in areas where you are not a domain expert, then leave user documentation to someone else.
GeneralThe user is innocent! PinPopular
OriginalGriff29-Aug-22 3:02
mveOriginalGriff29-Aug-22 3:02 
GeneralRe: The user is innocent! Pin
jeron129-Aug-22 4:28
jeron129-Aug-22 4:28 
GeneralRe: The user is innocent! Pin
Doug Domeny29-Aug-22 7:49
professionalDoug Domeny29-Aug-22 7:49 
GeneralRe: The user is innocent! Pin
Fabio Franco30-Aug-22 2:14
professionalFabio Franco30-Aug-22 2:14 
GeneralRe: The user is innocent! Pin
matblue2530-Aug-22 7:29
professionalmatblue2530-Aug-22 7:29 
GeneralRe: The user is innocent! Pin
Chris Maunder31-Aug-22 8:47
cofounderChris Maunder31-Aug-22 8:47 
GeneralAttributing blame isn't beneficial Pin
Lorenzo Bertolino28-Aug-22 22:28
professionalLorenzo Bertolino28-Aug-22 22:28 
GeneralRe: Attributing blame isn't beneficial Pin
Doug Domeny29-Aug-22 7:44
professionalDoug Domeny29-Aug-22 7:44 
GeneralRe: Attributing blame isn't beneficial Pin
Lorenzo Bertolino29-Aug-22 20:09
professionalLorenzo Bertolino29-Aug-22 20:09 
GeneralRe: Attributing blame isn't beneficial Pin
Fabio Franco30-Aug-22 2:18
professionalFabio Franco30-Aug-22 2:18 
GeneralAll above but the user PinPopular
Nelek28-Aug-22 22:13
protectorNelek28-Aug-22 22:13 
GeneralRe: All above but the user Pin
jeron129-Aug-22 4:29
jeron129-Aug-22 4:29 
GeneralRe: All above but the user Pin
Doug Domeny29-Aug-22 7:51
professionalDoug Domeny29-Aug-22 7:51 
GeneralRe: All above but the user Pin
Nelek29-Aug-22 9:17
protectorNelek29-Aug-22 9:17 
GeneralRe: All above but the user Pin
maze330-Aug-22 23:56
professionalmaze330-Aug-22 23:56 
GeneralThe product manufacturer's fault for Pin
Shao Voon Wong28-Aug-22 21:44
mvaShao Voon Wong28-Aug-22 21:44 
GeneralRe: The product manufacturer's fault for Pin
trønderen29-Aug-22 6:51
trønderen29-Aug-22 6:51 

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.