TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
Steven Jong observed about Hope Creskoff's comments on software
metrics:
<<Her comment that measuring developer productivity by lines of
code written
"has been proven to be an ineffective way to measure a
developer's
productivity" surprised me. Have Tom DeMarco and Watts Humphrey
suddenly
stopped advocating that metric? I don't think so. That metric is
alive and
well, though admittedly the engineers are kicking.>>
The problem with the "lines of code" metric is that it rewards
inefficient coding. Rather than counting lines of code, many
software developers these days are using the function point as
their key metric. What's a function point? Well, at the risk of
oversimplification, the traditional dataprocessing transactions
(add an XYZ record, display an XYZ record, edit an XYZ record,
delete an XYZ record) translate to four function points.
Since software documentation is closely tied to these
transactions (whether that documentation is menu-based or
task-based), you can estimate the size of a documentation
project using this same metric.
For more information about function points, see the
International Function Point Users Group Web site:
George Hayhoe Associates
Voice: +1 803-642-2156
Fax: +1 803-642-9325
Award-winning Web site: http://www.ghayhoe.com
TECHWR-L (Technical Communication) List Information: To send a message
to 2500+ readers, e-mail to TECHWR-L -at- LISTSERV -dot- OKSTATE -dot- EDU -dot- Send commands
to LISTSERV -at- LISTSERV -dot- OKSTATE -dot- EDU (e.g. HELP or SIGNOFF TECHWR-L).
Search the archives at http://www.documentation.com/ or search and
browse the archives at http://listserv.okstate.edu/archives/techwr-l.html