NOTE: use Perl; is on undef hiatus. You can read content, but you can't post it. More info will be forthcoming forthcomingly.
All the Perl that's Practical to Extract and Report
use Perl Log In
Friday June 18, 2004
04:13 AM
Programmers and writing
Why people continue insisting that programmers write texts, like documentation, articles, program evaluation issues and so on?
We all know that we can't do such things. We write, but who will read and understand it?
The Fine Print: The following comments are owned by whoever posted them. We are not responsible for them in any way.
Full
Abbreviated
Hidden
Loading... please wait.
an endless discussion thread about what features to include.
-- Jarkko Hietaniemi
Stories, comments, journals, and other submissions on use Perl; are Copyright 1998-2006, their respective owners.
Writing or Writing Well? (Score:1)
I know quite a few programmers who can and do write and many of them write well. Some don't, but many write well enough to communicate with a little editing. I think the rest are capable of writing well enough that a good tech writer can create readable documentation.
Besides, if you can't explain what the system does, how it does it, and why it does it, how could you have programmed it?
Re:Writing or Writing Well? (Score:1)
Re:Writing or Writing Well? (Score:1)
Almost every time I've written documentation for my code, I've found things that I don't want to write about because they're yucky. That's lead me to fix them and I like those results, if not the process.