TEMPLATE Requirements Review Workbook

  • Published on
    07-Apr-2018

  • View
    216

  • Download
    0

Embed Size (px)

Transcript

<ul><li><p>8/4/2019 TEMPLATE Requirements Review Workbook</p><p> 1/15</p><p>Department or Program Name</p><p>[SYSTEM/APPLICATION NAME]</p><p>TEMPLATE</p><p>FormalRequirements</p><p>ReviewResource</p></li><li><p>8/4/2019 TEMPLATE Requirements Review Workbook</p><p> 2/15</p><p>Resource </p><p>Template Formal Requirements Review Resource Workbook</p><p>TABLEOF CONTENTS</p><p>Business Needs/Core Requirements Interview Record..............................................3</p><p>Supervisor........................................................................................................................3</p><p>Down line..........................................................................................................................3</p><p>Down line..........................................................................................................................3</p><p>Facilitated Team Deliverable Review Process.............................................................4</p><p>Requirements Review Sample Agenda ................................................................11</p><p>Business Requirements Review Checklist.................................................................12</p><p>Business Requirements Review Findings Summary................................................15</p></li><li><p>8/4/2019 TEMPLATE Requirements Review Workbook</p><p> 3/15</p><p>Template Formal Requirements Review Resource Workbook</p><p>Business Needs/Core Requirements Interview Record</p><p>The Interview Record is used to document the interviews that are done as part of gathering businessrequirements. Included here is a sample Interview Record that was used for the Enterprise GIS Project.</p><p>Business Needs/Core Requirements Interview Record Enterprise GIS Project</p><p>Date: Position:</p><p>Name:Location:Objective:</p><p>Interviewer:</p><p>Introduction:</p><p>The University of Minnesota is preparing a business case and an eventual RFP for a University-wide GISsolution. GIS means many things to many people, ranging from AutoCAD to Space Management to GPStracking. Our plan is to navigate through the process of identifying stakeholders, preparing a list ofvendors available, generating a high-level set of business needs and functionality the organization wouldexpect from a GIS system, and sending out a Request for Information. This will give us some betterunderstanding as we then work with vendors to educate ourselves to the options of GIS while educating</p><p>the vendors to our actual needs. You are being interviewed as a key stakeholder or subject matter expertin describing the Universitys GIS needs.</p><p>Pre-requisites:</p><p>N</p></li><li><p>8/4/2019 TEMPLATE Requirements Review Workbook</p><p> 4/15</p><p>Template Formal Requirements Review Resource Workbook</p><p> Enter notes and Issues</p><p>Facilitated Team Deliverable Review Process</p><p>This document describes the process to prepare for, conduct, and respond to issues identified during aformal team deliverable review process.</p><p>Roles</p><p>Note: One person can play multiple roles. Having multiple roles during the review process will dependon the size of the review:</p><p>Role DescriptionProject Manager(PM)</p><p>Person held accountable for ensuring project success, leading the project team to achieveits objectives, ensuring effective communications with management and other non-projectorganizations, and ensuring that project problems are identified and resolved in a timelymanner.</p><p>Lead Person held accountable for deliverables in their discipline area and leading the team in</p><p>that discipline to achieve the objectives.Author Person who wrote the deliverable and clarifies the issues brought up in the review.Moderator Person responsible for scheduling the meeting, ensuring that the attendees have the</p><p>deliverable in a timely manner, ensuring the meeting stays on topic, on time andaccomplishes the stated goal(s). Facilitator is a term often used interchangeably withModerator.</p><p>Reviewer Person responsible for adequately reviewing the deliverable and documenting any issue.Scribe Designated person responsible for documenting discussion topics, decisions and action</p><p>items.</p><p>Phases Tasks Owner 1.0 Planning 1. Determine appropriate type of review</p><p>2. Form review team and verify availability of eachb</p><p>PM, LeadPM, LeadM d t</p></li><li><p>8/4/2019 TEMPLATE Requirements Review Workbook</p><p> 5/15</p><p>Template Formal Requirements Review Resource Workbook</p><p>Phases Tasks Owner appropriately</p><p>2. Check the completed deliverable into the projectsconfiguration management system</p><p>Author</p><p>Checklists, Templates and Links</p><p> Review Findings Summary Form Deliverables Review Checklist Review Meeting Summary</p><p>Goal</p><p>Optimize the effectiveness and quality of our reviews and reviewer feedback by ensuring the appropriateplanning, preparation, and participation through a standard set of procedures and guidelines.</p><p>Deliverable Verification Process</p><p>As part of the SDLC, review processes for each SDLC Phase have been established. Formal teamreviews will be required for Business Requirements, Technical Design, and Testing deliverables. Formalteam reviews for other project deliverables, such as Business Case, Charter, and project close out are</p><p>recommended. More information on the SDLC milestones, activities, and deliverables to be formallyreviewed by project stakeholders and project teams can be found on the US PMO website.</p><p>The information in this document is designed to take University Services project teams through effectiveformal team reviews of key project deliverables before those deliverables are passed to the next phasefor execution.</p><p>1.0 Planning Phase</p><p>1.1 Objectives</p><p> Gather review package. Form review team.</p></li><li><p>8/4/2019 TEMPLATE Requirements Review Workbook</p><p> 6/15</p><p>Template Formal Requirements Review Resource Workbook</p><p> Knowledgeable peers with at least one person notworking on the project</p><p> Stakeholders of the deliverable One person new to the process and/or a person who</p><p>lacks the knowledge of area the deliverable addresses Management, if applicable A representative of QA, if applicable</p><p> Project Managersets up work assignments for Review Team.</p><p> Project Managerand Lead determine if an orientation meeting is needed.</p><p> Authorprepares deliverable to be reviewed.</p><p> Authornotifies Moderator that the deliverable is complete.</p><p> Authorprovides Moderator with an estimate as to how long a Reviewer will taketo adequately review the deliverable. Moderatorensures that Review Team is selected.</p><p> Moderatorschedules the review meeting. For maximum effectiveness and efficiency, the review meeting should be</p><p>as short as possible.</p><p> Moderatorinvites Review Team at minimum two weeks in advance.</p><p> If an Email is used instead of an orientation meeting, Moderatorensures reviewpackage is complete to be emailed to Review Team at minimum five businessdays in advance and documents the areas that would be covered in theOrientation phase. Otherwise, Moderatorschedules the orientation meeting atminimum five business days in advance.</p><p> Moderatorchecks with Project Manager and Lead to reschedule the reviewbased on who cannot attend. Project Managerand Lead take intoconsideration getting Reviewers feedback outside of the meeting if they cannotattend.</p><p> Moderatorreviews at a high-level the deliverable for completeness andreadiness before providing it to Review Team.</p><p> Ensures that the deliverable is of a reasonable size to be reviewed.</p><p> Moderatorreviews and enhances checklist(s) and form(s) if needed. Moderatorcompiles review packet.</p><p> Deliverable Kickoff Sheet</p></li><li><p>8/4/2019 TEMPLATE Requirements Review Workbook</p><p> 7/15</p><p>Template Formal Requirements Review Resource Workbook</p><p> Moderatorhands out (or provides link to) review material, checklists, and reviewforms.</p><p> Moderatornotifies Review Team the task the time spent on the review shouldbe put under.</p><p> Authorprovides overview or demo, answers questions on project, and points outspecial items to pay attention to.</p><p> Moderatorexplains review process and review meeting expectations. Remind Reviewers of general meeting guidelines. Point out key</p><p>guidelines if necessary. Identify the major or minor issues on Review Findings Summary form. Identify severity of issue (major or minor) on Review Findings Summary</p><p>form. Note that grammar and spelling issues should be on a separate review</p><p>form or on the deliverable. This should not be brought up in the reviewmeeting.</p><p> If there is a show-stopper identified in the deliverable, inform Moderatorimmediately so a decision can be made to reschedule the review andrevise the deliverable.</p><p> The Review Preparation Form should be emailed to Scribe, Author, andModeratorat minimum one business day before the review meeting.</p><p> Moderatoridentifies Scribe.</p><p> Moderatorsets preparation expectations, discusses expected time involvement,confirms review date and gets confirmation from Reviewers.</p><p> Authordoes not change the deliverable once it has been given to Reviewers ifthe deliverable was sent as a link to the deliverable.</p><p>3.0 Preparation Phase</p><p>3.1 Objectives</p><p> Maximize use of time during the review meeting. Prioritize review findings. Concentrate on the major issues. Document all issues.</p></li><li><p>8/4/2019 TEMPLATE Requirements Review Workbook</p><p> 8/15</p><p>Template Formal Requirements Review Resource Workbook</p><p> Deliverable being reviewed Completed Review Preparation Form</p><p> Notes on grammar issues to be given to Author</p><p>4.0 Review Meeting Phase</p><p>4.1 Objectives</p><p> Provide opportunity for group synergy. Create shared knowledge of deliverable.</p><p> Identify major and minor issues in deliverable.</p><p>4.2 Procedures</p><p> Authoris available for clarification.</p><p> Authorneeds to remember that only the deliverable is being reviewedavoidbeing defensive.</p><p> Moderatorarrives at meeting location early to prepare. Sets up equipment. Brings in additional chairs. Prepares dial-in attendees.</p><p> Moderatorintroduces Review Team, if needed. Moderatorbriefly explains the purpose and importance of meeting.</p><p> Moderatorreviews key principles of meeting. Focus comments on the deliverable, not Author. Identify issues. Do not discuss solutions. Give list of grammar issues to Author. Do not discuss grammar issues</p><p>during review. One person speaks at a time.</p><p> Moderatoridentifies the option for discussion:</p><p> Solicit feedback on issues, seeking confirmation/verification from thegroup.</p><p> Do not discuss (or have a very brief discussion) whether issue is adefect.</p><p>M d t ifi R i h th i f th d li bl th t </p></li><li><p>8/4/2019 TEMPLATE Requirements Review Workbook</p><p> 9/15</p><p>Template Formal Requirements Review Resource Workbook</p><p>5.1 Objectives</p><p>Assess each issue. If it is a defect, remove it if necessary.</p><p> If it is an issue, then resolve the issue.</p><p> Produce written summary of major issues.</p><p>5.2 Procedures</p><p> Author corrects defects and typo found, resolves issues raised and modifiesdeliverable accordingly. Author marks issues list (provided in the ReviewMeeting phase) to indicate action taken.</p><p>Author corrects any other project documents based on issues identified in thereviewed deliverable.</p><p> Author records any uncorrected defects in the projects defect tracking system. When finished, Author documents issue resolution and reworked deliverable for</p><p>verification.</p><p>6.0 Verify Phase</p><p>6.1 Objectives</p><p> Assess the reworked deliverable. Pass or fail the deliverable.</p><p>6.2 Procedures</p><p> Author reports the number of major and minor issues/defects found andcorrected and the actual rework effort to the Lead and/or Project Manager.</p><p> Lead and/or Project Manager confirms that Author has addressed every item onthe issues list. Lead and/or Project Manager determines whether Author made</p><p>appropriate decisions as to which defects not to remove, which issues not toresolve, and which improvement suggestions not to implement.</p><p> Lead and/or Project Manager examines the modified deliverable to determinewhether the rework has been performed correctly. Lead and/or Project Managerreports any findings to Author so rework can be declared complete incorrect</p></li><li><p>8/4/2019 TEMPLATE Requirements Review Workbook</p><p> 10/15</p><p>Template Formal Requirements Review Resource Workbook</p><p>Major issue Defects that would cause further errors in downstream deliverablesmaking it harder to correct; would affect the results or behavior in an</p><p>adverse way; affects large areas</p><p>Minor issue Defects that would not have impacts that are far reaching or broad;areas of functionality that can either be worked around or ignored;affects limited areas</p><p>Grammar issue Defects that can be overlooked with no loss of functionality. Ex:grammar and spelling errors.</p></li><li><p>8/4/2019 TEMPLATE Requirements Review Workbook</p><p> 11/15</p><p>Template Formal Requirements Review Resource Workbook</p><p>Requirements Review Sample Agenda</p><p>AgendaAnd Meeting Report</p><p>Meeting Purpose To review and acknowledge the features and functionality defined by business as required withinthe proposed solution. The requirements developed in the Analysis/Requirements phase provides</p><p>developers with a detailed description of the business capability to be developed. It is according tothe Business Requirements Document that the capability is designed, built, and tested.Requirements gathering and elicitation involves close collaboration between all known end users.This meeting is to review the final business requirements to ensure completeness and correctnessin preparation for turning over for detailed technical design and development.</p><p>Facilitator</p><p>Meeting Details Date:Time:Location:</p><p>Attendees = present, = planned absence, = not present,= conference call; use bold for names of Decision Makers</p><p>Advanced Reading Materials: Business Requirements Document Review Findings Summary</p><p>Meeting Topics Reference Led By Time</p><p>Administration: Meeting Overview Introductions</p><p>5 minutes</p><p>Review: Business Requirements Document</p><p>Business RequirementsDocument</p><p>60 minutes</p><p>Discuss and Approve: N/A 15 minutes</p><p>[Project Name]Business Requirements Review Meeting</p></li><li><p>8/4/2019 TEMPLATE Requirements Review Workbook</p><p> 12/15</p><p>Template Formal Requirements Review Resource Workbook</p><p>Business Requirements Review Checklist</p><p>Business Requirements Review Checklist</p><p>Checklist Description: This checklist captures common elements that should be present in any businessrequirements definition document. It is presented during the Business Requirements Review process tostimulate thought, guide brainstorming, and to ensure the business-defined features and functionality beingoutlined contains all proper requirements considerations. To ensure that the system you are preparing to buildfully addresses the necessary user and technical needs, features, and functionality, assess the requirements</p><p>considerations that apply to your subject matter expertise and business needs.</p><p>Project Name: Date:</p><p>Reviewer: Project Manager:</p><p>Business Requirements Document Format Comments</p><p>Is each requirement numbered or uniquely identifiable from other requirements(document uses numbered outline codes, etc.)?</p><p>Is each requirement written in clear, concise, unambiguous language?Is something described as a standard without citing the specific source?</p><p>Is any necessary information missing from a requirement? If so, is it identifiedas TBD and how it will be accounted for during design?Are there any of the following weasel words e.g. various, mostly, suitable,integrate, maybe, c...</p></li></ul>