Aug. 31st, 2006

mythteller: (vocal_outrage)
Dear Programmer,

When I ask you to provide a definition for a component in the application, don't tell me that I don't need that information. I'm the writer, so I know what I need to include in my documentation. You're a coding monkey, so stick to what you're good at.

Please don't provide information that tells me how stupid you think I am. If I need a definition for an object call LargeRedBall, I need something a bit more substantial than a definition like "LargeRedBall is a large ball object of type red." That's not helpful. I need to know what it is using terms that are not used in the name of the thing and I need an example of its use.

Also, don't sigh and act like you're doing me a huge favour giving me this information. I'm not a technical writer because I'm too stupid to be a programmer.

Sincerely yours,

Hobbes
The Brittle Technical Writer

Profile

mythteller: (Default)
mythteller

January 2025

S M T W T F S
   1234
567891011
12131415161718
19 20 2122232425
262728293031 

Most Popular Tags

Page Summary

Style Credit

Expand Cut Tags

No cut tags
Page generated Jul. 8th, 2025 01:17 am
Powered by Dreamwidth Studios