Software Engineering Management 8/6/2018 Software Engineering Management Dr. M.E. Fayad, Professor Computer Engineering Department, Room #283I College of Engineering San José State University One Washington Square San José, CA 95192-0180 http://www.engr.sjsu.edu/~fayad, m.fayad@sjsu.edu  1998-06 Fayad SJSU -- CmpE

Lecture B3c: Documenting Software Processes - 2 8/6/2018 Lecture B3c: Documenting Software Processes - 2 2  1998-06 Fayad SJSU -- CmpE M.E. Fayad

3 Lesson Objectives Understand the recommendations for 8/6/2018 Lesson Objectives Understand the recommendations for documenting process. Discuss the essential process elements Understand how to document S/W processes Template Symbolic notation UML – activity diagram 3  1998-06 Fayad SJSU -- CmpE M.E. Fayad

RECOMMENDATIONS FOR DOCUMENTING PROCESSES 8/6/2018 RECOMMENDATIONS FOR DOCUMENTING PROCESSES Concentrate on tracing inputs to outputs encapsulate creative processing Identify all reviews define products required approval authority Identify where CM occurs Consistently specify all roles involved developers SQA testers customers 4  1998-06 Fayad SJSU -- CmpE M.E. Fayad

ESSENTIAL OO PROCESS ELEMENTS 8/6/2018 ESSENTIAL OO PROCESS ELEMENTS Map method products to each software activity graphics tables repositories Identify what/when from CASE tools Identify appropriate OO notation for your documentation Specify what level of coordination must exist between objects Essential OO Processes to Document list Class Analysis Object Design Object Testing Reuse of Part OO standards naming conventions inheritance rules limitations 5  1998-06 Fayad SJSU -- CmpE M.E. Fayad

INTEGRATED GRAPHICAL/ TEXTUAL DOCUMENTATION RECOMMENDED 8/6/2018 INTEGRATED GRAPHICAL/ TEXTUAL DOCUMENTATION RECOMMENDED Process Documentation Format Considerations Example Mc Flow Blow-up a bubble into text description graphics maximize communication text expands detail 6  1998-06 Fayad SJSU -- CmpE M.E. Fayad

LESSONS LEARNED FROM PROCESS DEVELOPMENT 8/6/2018 LESSONS LEARNED FROM PROCESS DEVELOPMENT Ingrain metrics collection directly into processes Development team should “own” processes Development team should “enforce” processes Process assessment should be part of process Metrics collection as part of process Ingrained - repeatable - consistent Use example 7  1998-06 Fayad SJSU -- CmpE M.E. Fayad

OO DEVELOPMENT PROCESS SUMMARY 8/6/2018 OO DEVELOPMENT PROCESS SUMMARY 1. Processes map software methods from the classroom to the computer room translate theory to action 2. Processes especially important for new OO development teams maximizes individual contributions 3. Processes must be tuned for specific projects tuned for specific attributes 4. Integrated graphics and text provide effective documentation format eases communication and maintenance 8  1998-06 Fayad SJSU -- CmpE M.E. Fayad

Process Documentation – Template & Example 8/6/2018 Process Documentation – Template & Example Process Documentation Template Micro-Development Process – Software Inspection 9  1998-06 Fayad SJSU -- CmpE M.E. Fayad

Process Documentation – Symbolic Notation 8/6/2018 Process Documentation – Symbolic Notation Roles Input description -- Process inputs i,e. tools & information Role 1 Role 2 Participants Chart Process Step Name Output description -- Process outputs i,e. tools, manual, & information 10 Transition Arrow Role N  1998-06 Fayad SJSU -- CmpE M.E. Fayad

Process Documentation – Symbolic Notation 8/6/2018 Process Documentation – Symbolic Notation Yes Filled Process Box Decision Diamond No Parallelogram shows concurrency Parallel Process Step 11  1998-06 Fayad SJSU -- CmpE M.E. Fayad

Process Documentation – Symbolic Notation - Example 8/6/2018 Process Documentation – Symbolic Notation - Example 12  1998-06 Fayad SJSU -- CmpE M.E. Fayad

8/6/2018 Discussion Questions Name the roles in the following software processes Spiral Model Requirement Engineering Software Testing Software Review Interaction Diagram Class Diagram Software development planning 13  1998-06 Fayad SJSU -- CmpE M.E. Fayad

Questions for the Next Lecture 8/6/2018 Questions for the Next Lecture Activity Diagram 14  1998-06 Fayad SJSU -- CmpE M.E. Fayad

8/6/2018 Tasks for Next Lecture Task 1: Read Appendix A – Fayad’s Book & any materials on UML – Activity Diagrams Please note that all deliverables must be submitted electronically as MS Word format. 15  1998-06 Fayad SJSU -- CmpE M.E. Fayad