![2 KICK-OFF
An Optional Step In A Review Procedure Is A Kick-off Meeting. The Goal Of This Meeting Is To Get Everybody On
The Same Wavelength Regarding The Document Under Review And To Commit To The Time That Will Be Spent On
Checking. Also The Result Of The Entry Check And Defined Exit Criteria Are Discussed In Case Of A More Formal
Review. In General A Kick-off Is Highly Recommended Since There Is A Strong Positive Effect Of A Kick-off
Meeting On The Motivation Of Reviewers And Thus The Effectiveness Of The Review Process. At Customer Sites,
We Have Measured Results Up To 70% More Major Defects Found Per Page As A Result Of Performing A Kick-off,
[Van Veenendaal And Van Der Zwan, 2000]
During The Kick-off Meeting The Reviewers Receive A Short Introduction On The Objectives Of The Review And
The Documents. The Relationships Between The Document Under Review And The Other Documents (Sources) Are
Explained, Especially If The Number Of Related Documents Is High.
Role Assignments, Checking Rate, The Pages To Be Checked, Process Changes And Possible Other Questions Are
Also Discussed During This Meeting. Of Course The Distribution Of The Document Under Review, Source
Documents And Other Related Documentation, Can Also Be Done During The Kick-off.](https://image.slidesharecdn.com/phasesofaformalreview-171105095532/85/Phases-of-a-formal-review-5-320.jpg)
Phases of a formal review
- 2. 1 PLANNINGThe review process for a particular review begins with a 'request for review' by the author to the moderator (or inspection leader). A moderator is often assigned to take care of the scheduling (dates, time, place and invitation) of the review. On a project level, the project planning needs to allow time for review and rework activities, thus providing engineers with time to thoroughly participate in reviews. For more formal reviews, e.g. inspections, the moderator always performs an entry check and defines at this stage formal exit criteria. The entry check is carried out to ensure that the reviewers' time is not wasted on a document that is not ready for review. A document containing too many obvious mistakes is clearly not ready to enter a formal review process and it could even be very harmful to the review process. It would possibly de-motivate both reviewers and the author. Also, the review is most likely not effective because the numerous obvious and minor defects will conceal the major defects. Although more and other entry criteria can be applied, the following can be regarded as the minimum set for performing the entry check: • A short check of a product sample by the moderator (or expert) does not reveal a large number of major defects. For example, after 30 minutes of checking, no more than 3 major defects are found on a single page or fewer than 10 major defects in total in a set of 5 pages. • The document to be reviewed is available with line numbers. • The document has been cleaned up by running any automated checks that apply. • References needed for the inspection are stable and available. • The document author is prepared to join the review team and feels confident with the quality of the document.
- 3. If The Document Passes The Entry Check, The Moderator And Author Decide Which Part Of The Document To Review. Because The Human Mind Can Comprehend A Limited Set Of Pages At One Time, The Number Should Not Be Too High. The Maximum Number Of Pages Depends, Among Other Things, On The Objective, Review Type And Document Type And Should Be Derived From Practical Experiences Within The Organization. For A Review, The Maximum Size Is Usually Between 10 And 20 Pages. In Formal Inspection, Only A Page Or Two May Be Looked At In Depth In Order To Find The Most Serious Defects That Are Not Obvious. After The Document Size Has Been Set And The Pages To Be Checked Have Been Selected, The Moderator Determines, In Co-operation With The Author, The Composition Of The Review Team. The Team Normally Consists Of Four To Six Participants, Including Moderator And Author. To Improve The Effectiveness Of The Review, Different Roles Are Assigned To Each Of The Participants. These Roles Help The Reviewers Focus On Particular Types Of Defects During Checking. This Reduces The Chance Of Different Reviewers Finding The Same Defects. The Moderator Assigns The Roles To The Reviewers.
- 4. Figure 3.1 Shows The Different Roles Within A Review. The Roles Represent Views Of The Document Under Review. Within Reviews The Following Focuses Can Be Identified: Focus On Higher-level Documents, E.G. Does The Design Comply To The Requirements; Focus On Standards, E.G. Internal Consistency, Clarity, Naming Conventions, Templates; Focus On Related Documents At The Same Level, E.G. Interfaces Between Soft Ware Functions; Focus On Usage, E.G. For Testability Or Maintainability. The Author May Raise Additional Specific Roles And Questions That Have To Be Addressed. The Moderator Has The Option To Also Fulfil A Role, Alongside The Task Of Being A Review Leader. Checking The Document Improves The Moderator's Ability To Lead The Meeting, Because It Ensures Better Understanding. Furthermore, It Improves The Review Efficiency Because The Moderator Replaces An Engineer That Would Otherwise Have To Check The Document And Attend The Meeting. It Is Recommended That The Moderator Take The Role Of Checking Compliance To Standards, Since This Tends To Be A Highly Objective Role, Which Leads To Less Discussion Of The Defects Found.
- 5. 2 KICK-OFF An Optional Step In A Review Procedure Is A Kick-off Meeting. The Goal Of This Meeting Is To Get Everybody On The Same Wavelength Regarding The Document Under Review And To Commit To The Time That Will Be Spent On Checking. Also The Result Of The Entry Check And Defined Exit Criteria Are Discussed In Case Of A More Formal Review. In General A Kick-off Is Highly Recommended Since There Is A Strong Positive Effect Of A Kick-off Meeting On The Motivation Of Reviewers And Thus The Effectiveness Of The Review Process. At Customer Sites, We Have Measured Results Up To 70% More Major Defects Found Per Page As A Result Of Performing A Kick-off, [Van Veenendaal And Van Der Zwan, 2000] During The Kick-off Meeting The Reviewers Receive A Short Introduction On The Objectives Of The Review And The Documents. The Relationships Between The Document Under Review And The Other Documents (Sources) Are Explained, Especially If The Number Of Related Documents Is High. Role Assignments, Checking Rate, The Pages To Be Checked, Process Changes And Possible Other Questions Are Also Discussed During This Meeting. Of Course The Distribution Of The Document Under Review, Source Documents And Other Related Documentation, Can Also Be Done During The Kick-off.
- 6. 3 PREPARATION The Participants Work Individually On The Document Under Review Using The Related Documents, Procedures, Rules And Checklists Provided. The Individual Participants Identify Defects, Questions And Comments, According To Their Understanding Of The Document And Role. All Issues Are Recorded, Preferably Using A Logging Form. Spelling Mistakes Are Recorded On The Document Under Review But Not Mentioned During The Meeting. The Annotated Document Will Be Given To The Author At The End Of The Logging Meeting. Using Checklists During This Phase Can Make Reviews More Effective And Efficient, For Example A Specific Checklist Based On Perspectives Such As User, Maintainer, Tester Or Operations, Or A Checklist For Typical Coding Problems. A Critical Success Factor For A Thorough Preparation Is The Number Of Pages Checked Per Hour. This Is Called The Checking Rate. The Optimum Checking Rate Is The Result Of A Mix Of Factors, Including The Type Of Document, Its Complexity, The Number Of Related Documents And The Experience Of The Reviewer. Usually The Checking Rate Is In The Range Of Five To Ten Pages Per Hour, But May Be Much Less For Formal Inspection, E.G. One Page Per Hour. During Preparation, Participants Should Not Exceed This Criterion. By Collecting Data And Measuring The Review Process, Company-specific Criteria For Checking Rate And Document Size (See Planning Phase) Can Be Set, Preferably Specific To A Document Type.
- 7. 4 REVIEW MEETING The Meeting Typically Consists Of The Following Elements (Partly Depending On The Review Type): Logging Phase, Discussion Phase And Decision Phase. During The Logging Phase The Issues, E.G. Defects, That Have Been Identified During The Preparation Are Mentioned Page By Page, Reviewer By Reviewer And Are Logged Either By The Author Or By A Scribe. A Separate Person To Do The Logging (A Scribe) Is Especially Useful For Formal Review Types Such As An Inspection. To Ensure Progress And Efficiency, No Real Discussion Is Allowed During The Logging Phase. If An Issue Needs Discussion, The Item Is Logged And Then Handled In The Discussion Phase. A Detailed Discussion On Whether Or Not An Issue Is A Defect Is Not Very Meaningful, As It Is Much More Efficient To Simply Log It And Proceed To The Next One. Furthermore, In Spite Of The Opinion Of The Team, A Discussed And Discarded Defect May Well Turn Out To Be A Real One During Rework.
- 8. 5 REWORK Based On The Defects Detected, The Author Will Improve The Document Under Review Step By Step. Not Every Defect That Is Found Leads To Rework. It Is The Author's Responsibility To Judge If A Defect Has To Be Fixed. If Nothing Is Done About An Issue For A Certain Reason, It Should Be Reported To At Least Indicate That The Author Has Considered The Issue. Changes That Are Made To The Document Should Be Easy To Identify During Follow-up. Therefore The Author Has To Indicate Where Changes Are Made (E.G. Using 'Track Changes' In Word-processing Software).
- 9. 6 FOLLOW-UP The Moderator Is Responsible For Ensuring That Satisfactory Actions Have Been Taken On All (Logged) Defects, Process Improvement Suggestions And Change Requests. Although The Moderator Checks To Make Sure That The Author Has Taken Action On All Known Defects, It Is Not Necessary For The Moderator To Check All The Corrections In Detail. If It Is Decided That All Participants Will Check The Updated Document, The Moderator Takes Care Of The Distribution And Collects The Feedback. For More Formal Review Types The Moderator Checks For Compliance To The Exit Criteria. In Order To Control And Optimize The Review Process, A Number Of Measurements Are Collected By The Moderator At Each Step Of The Process. Examples Of Such Measurements Include Number Of Defects Found, Number Of Defects Found Per Page, Time Spent Checking Per Page, Total Review Effort, Etc. It Is The Responsibility Of The Moderator To Ensure That The Information Is Correct And Stored For Future Analysis.