Page 88 -
P. 88

the spot, or if discussion lasts more than about five minutes, the moderator adds it to
                            the inspection log as an open issue and assigns it to the team member who brought it up
                            (and anyone else who is involved), so he can work with the author to resolve it. Once
                            all issues for the page are discussed, the moderator moves to the next page in the work
                            product.
                          Rework
                            After the inspection meeting is over, the author makes the changes in the inspection log
                            and works with the inspection team members to resolve all open issues. When the
                            changes are complete, the author turns the updated work product over to the moderator.
                          Follow-up
                            The moderator distributes the updated work product to the inspection team. Each team
                            member verifies that he can now approve the work product. If there are any issues that
                            were not fully resolved or additional defects that were not caught, he notifies the mod-
                            erator, who calls another inspection meeting and starts the inspection process over
                            again. Once the team gets through an inspection without any open issues and can agree
                            on any changes that must be made, the work product can be updated and distributed
                            for approval.
                          Approval
                            If any inspector feels that there are still further issues raised by the corrections to the
                            work product, another inspection meeting can be held; however, the project manager
                            and author can also work individually with everyone involved to make sure that the
                            changes are adequate. Once everyone on the team feels that the changes they identified
                            are adequate, they can approve the updated work product without holding another
                            inspection meeting.
                            The moderator adds a signature page to the work product and distributes a printed ver-
                            sion for signature approval. The signed work product is archived.

                          Manage the Author’s Expectations
                          Many people who have implemented inspections have found that it is very difficult for
                          authors to sit through an inspection meeting without defending their work. Instead of
                          providing clarification that is used to update the work product, they take over the discus-

                          sion and, by being defensive and loud, get the inspectors to agree not to report defects.
                          This is counterproductive: it leads to situations when the inspection team understands
                          what the author meant, but the work product, which remains unchanged, does not reflect
                          this. It is the moderator’s job to keep the discussions on track and prepare the authors for
                          the inspection.

                          A major challenge of the moderator role is keeping the author from altering the understand-
                          ing of the document through discussion. The purpose of the discussions is not to teach the
                          inspectors about the project; it is to change the document so that the author and all of the
                          inspectors will approve it. There is a simple rule in document inspection: if there is a misun-
                          derstanding about words in the document, they need to be clarified in the document, and
                          not just in the minds of the people who happened to attend the inspection meeting.


                   80  CHAPTER FIVE
   83   84   85   86   87   88   89   90   91   92   93