jump to navigation

is Documentation skill a requirement? December 28, 2006

Posted by TSAI HONG-BIN in Misc.

One of the most “geek” impression about software engineers are their “remarkable communication characteristics:” jargon, jargon and jargon (this should apply to other fields with proficiency anyway). Actually, two (software) engineers can communicate very efficiently and effectively if they both speak jargons. It helps quickly identify the essence of the topic, or, the problem (engineers don’t communicate if and only if they receive a bug report), however, never a good way to social. 

(murmur) Weird … why is that lawyers and doctors speaking jargons always receive admiration?

Anyway, I got a feeling that most engineers dislike to do documentation. Maybe one of the main reasons is that “my writing plus your reading cost much more time than asking me directly.” .. well, the other main reason may be “source code is the best documentation.” They are both true and popular execuses for engineers denying to do documentation. The question is, the reason they reject to do documentation is really what they claimed, or what they don’t want to admit that they are not good at it? The latter, I figured.

Engineers, unfortunately, are linguists in machines’ world. hey, wait, plz don’t shush me.. I got my theory~…

(to be continue…)



1. chrisfiore5 - January 2, 2007

just a random hit, furseal’s lair… hope you have a great new year. peace.

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out /  Change )

Google+ photo

You are commenting using your Google+ account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )


Connecting to %s

%d bloggers like this: