Figure Reproducibility initial documentation
Agenda (110 Minutes)
- (60 minutes) Figure Reviews
- (50 minutes) Group meeting
Figure Reviews
This is a team paring exercise. Your team will work with your partner team(s) to review your figure generation. Combine your teams and split up in to groups (some people from each team). Have one group review your teams installation and figure instructions and the other group review the other teams instructions. This should feel very similar to what we did a few weeks ago, you can just repeat the review. Hopefully things have been updated based on previous feedback and now are working better.
Recommended Agenda
- (5 minutes) Break up into groups. Split people up so that there are members of each of your partner team(s) in each group.
- (5 minutes) Quick Introductions. Identify a timekeeper, notetaker, code reviewer, and facilitator.
- (30 minutes) Review Installation and Figure instructions
- (10 minutes) Discussion and brainstorming about improvements
- (10 minutes) Finish typing up report to instructors
In your group, have someone that is not from the code development team to try to install the software and review the figure instructions. Have the group members from the development team hold back and only give advice and support if there is a problem. The idea is to streamline the process so that the figure instructions are sufficient for someone outside of the development team to be able to reproduce the figure (within reason) without needing to have a developer to help. As a group take lots of notes and review the documentation to the development group some constructive feedback. If you are a member of the code’s development team, use this as an opportunity to fix problems as they are discovered.
As a group, prepare a report for the instructor and the development team. This report should provide the following:
- List of the evaluation group members with an indication about which capstone team they are on.
- Was someone outside the development team able to understand and possibly reproduce the figure? If not, what was the problem?
- What are the open loops still on the project?
- Is there anything that needed to be added to the code/instructions to make the project easier to understand?
- Was there anything you could add to the project to help make the project better?
This is a group effort, use the public team’s folder to share the report with each other and the instructors.
Group meeting
Conduct a group meeting for the remainder of the class. Check your project milestones, progress and make plans to practice and finish your presentation by next week.