|
|
|
|
|
by ironchef
2003 days ago
|
|
Maybe the documentation you've written hasn't been good? I've found well-written documentation to be a good way to avoid having folks bother me. I tend to treat it as a first class citizen artifact of my work (along with tests). Have it be as auto generated as possible. The above being said, I've also sometimes struggled to put myself in the user's shoes to understand what are the things I should emphasize in the documentation. |
|
My user documentation is usually hand written and in a rather linear style, split by tasks. "You want to reach this goal, do the folling". On the other hand i am aware that as a developer, our style of submitting information to peers is sometimes different. Non-developers have a hard time to follow and sometimes a few explanation attempts are needed to get the information over the river (both ways).
This would tell me that an in-between person should create documentation. This person does not exist in my vicinity...
I will however take the feedback from this thread into account and point at documentations more often. Maybe it has an effect.