alesha@auto-trol.com (Alec Sharp) (05/20/91)
We do reviews of various documents, but want to improve. We review
requirements, functional spec, and design spec, and do a quick
check on code. There are two areas in particular that I'd like to
improve.
First, the development cycle is very iterative, and we often
discover things during any phase that require changes to a previous
document. We handle this by making the changes and distributing
the changes to the "customers" for that document. Wd don't review
the changes unless one or more "customers" request it. Of course,
the "customers" are too busy to look at the changes, so in practice
very few changes get re-reviewed, which sometimes leads to more
errors. Does anyone out there have a better way to handle re-
reviews of changes?
Second, projects come in different sizes. What is appropriate for
a large project is huge overkill for a bug fix. We make some
fairly arbitrary decisions and try to do:
Full reviews of requirements, functional spec, and design for
projects estimated to take longer than one person-month.
A smaller requirements review by one or two people, then a
single full review of functional spec and design for projects
one person-week to one person-month.
A smaller requirements review by one or two people, then a
single smaller review of functional spec and design by one or
two people for projects up to one-person week.
A code review by one person for bug fixes.
This is an arbitrary breakout and doesn't take into account project
complexity, or the ability of some people to do in a week what
others may take a couple of months over. Does anyone have a better
scheme they use for reviews of different size projects?
Please send me mail at:
alesha%auto-trol@sunpeaks.central.sun.com
and I'll summarize the results if there's enough response.
--
------Any resemblance to the views of Auto-trol is purely coincidental-----
Don't Reply - Send mail: alesha%auto-trol@sunpeaks.central.sun.com
Alec Sharp Auto-trol Technology Corporation
(303) 252-2229 12500 North Washington Street, Denver, CO 80241-2404