CS-314, Spring 2016
Design Studio 1. Inspections

Pre-class work and Pre-Quiz, In-class work, and Post-class work for DS1.

The design studio pre-class work is individual. The design studio pre-Quiz is an individual quiz.

Pre-Quiz DUE Tuesday 26 January 2016, 11:55 PM

CREDIT: Pre-Quiz: 10 points, Design Studio: 10 points

Pre-class work and Pre-Quiz Purpose:

• To understand what a code review is and why it is useful.
• To understand the steps in formal and informal inspections/reviews.
• To understand the strengths and weaknesses of different types of inspections/reviews.
• To practice preparing for an inspection/review.

In-class activity Purpose:

• To participate in a formal inspection.
• To practice a review process that will be used as part of the development process in CS 314.

Post-class work Purpose:

• To personally assess your learning from the pre-work and in-class activity.
• To practice constructing a small writing that presents a well-constructed, concise and well-argued point.

Design Studio Pre-class work - Do This Before Class, Quiz deadline Tues night, 11:55pm

INDIVIDUAL WORK

Description:

The pre-work contains background information on inspections and also materials that we will use during the in-class activity. You will be participating in a code inspection during class. Each person will inspect the code from a different persepective, or role. We will be using 3 roles: Moderator/End User, Maintainer, and Tester. These roles are explained in the design studio pre-work file (DS1-PRE.pdf).

Tasks:

1. Determine your role through discussion with your teammates. Your team should have one member playing each role.
If you are not yet in a team you can assume a role based on your last name:

• Last name begins with A-F: Moderator/End User
• Last name begins with G-N: Maintainer
• Last name begins with O-Z: Tester

2. Complete the pre-class readings:

• Study the article "Four ways to a Practical Code Review" from Smart Bear (Jason Cohen) at http://www.methodsandtools.com/archive/archive.php?id=66 or from the PDF file.
• Study the 4 slides on inspections in the CS314SP2016-inspections.pdf file.

3. Complete the pre-class inspection preparation:

• Review the code from your role perspective, as described in the design studio pre-work file (DS1-PRE.pdf). The code can be found in the AdventureCode.pdf file, or you can import it into Eclipse from the adventure.jar file. The first page of the pdf listings is a diagram of the classes in the program and how they are connected. The second page is a diagram of the rooms in the cave and how they are connected. You will only be inspecting the AdventureGame.java and Player.java listings. The rest of the code is provided for background and understanding of how the game works.
• Make notes on the listings to indicate the file name, line number, and problem you found. Use the checklists associated with your role, available in DS1-InspChecklists.pdf.
• You need to bring these notes with you to class. It would be a good idea to also bring listings of the 2 files that are being inspected, AdventureGame.java and Player.java so that you can follow what other people have found in their review of these files.

4. Take the Q1 Pre-Inspection Quiz, available in Canvas.

Grading:

1. You will receive an individual quiz grade for the pre-quiz.

Design Studio In-Class Activity - Do This in Groups of 3 - Each Person Must Have a Different Role

Description:

You will participate in an inspection meeting to log defects in the 2 code files AdventureGame.java and Player.java. Follow the instructions for Task 1 in DS1-InClass.pdf.

What you need to do:

1. With your team, log defects you found in your roles using the logging sheet found in DS1-Log.pdf.

2. Turn in your log sheet at the end of class.

Grading:

The team portion of your DS1 grade (5 points) will be based on your log sheet.

Design Studio Post-work - Do This After Class

INDIVIDUAL WORK

Post-class retrospective writing DUE Thursday 28 January 2016, 11:55 PM

Description:

You need to write a self-learning assessment for the in-class activity. Follow the instructions for Task 2 in DS1-InClass.pdf.

What you need to do:

1. Write your assessment and submit it via Canvas.

Grading:

The individual portion of your DS1 grade (5 points) will be based on how thoughtfully you have addressed the questions in Task 2, and also on how well you have constructed your writing (paragraphs and arguments).