An Observation On the Use of the English Language by Software Developers

[billroper]

Documentation is a wonderful thing.

I suppose I should write some more of it.

I hope that everyone will read it if I do.

Sadly, my observation is that most developers write documentation at gunpoint and read it under threat of torture.

Or maybe I'm just being excessively cynical today. :)

Comments

[madfilkentist]

Maybe they read it only under threat of torture because it looks as if it were written at gunpoint.

[filkerdave.livejournal.com]

Most developers do not write useful documentation, even at gunpoint.

And nobody ever reads it.

[kevinnickerson.livejournal.com]

No. No. I think you have attained exactly the correct level of cynicism today.

[rono-60103.livejournal.com]

I do read documentation.

But, what I write is probably of marginal use to anyone (even me). Then again, as you implied, much is of marginal use, period, due to the priority it is given.