Goals
This lab session and next are a working meeting for your project team. In first project lab meeting, your team will work out the project plan and draft your proposal to submit.
Prelab preparation
To prepare for lab, do the following:
- Review project writeup for project logistics and schedule.
- Plan to attend same lab session as your partner.
- Connect with your partner to
- Establish norms for how you communicate and make decisions
- Share with one another what you hope to learn, explore, or do in completing your project
Logistics: setup project repository
You've been git-wrangling all quarter as part of your individual development process; the benefits of revision control become even more critical when coordinating work across multiple contributors.
This quick lab exercise is to get your team started on using git collaboratively. Each project has its own remote repository on GitHub; you should have received an email invitation to access it. This remote repository is the "drop point" where your team synchronizes the joint work. You also should have received an email invitation to access the project mirror repo, which contains a skeleton project structure that you can use a starting point for your project.
The basic workflow goes like this. Each team member has a local copy of the repository on their laptop. Edit files in the local repository and commit changes. When your latest work has stabilized to a state that is ready to share, use git push to send your updates to the remote. Your teammate then uses git pull to fetch changes from the remote which are brought into their local repository.
Each team member should change to their cs107e_home directory and make a local clone of the team's project repository:
$ cd ~/cs107e_home
$ git clone git@github.com:cs107e/project-[YOUR-GITHUB_USERNAMES].git project
Have each team member do the following to confirm that your local project repository is correctly configured.
- In the local project repository, edit the file
proposal.mdfile and add your name to the list of team members. Save the file. - Commit your change and push to Github.
- Have your teammates pull your change.
During the pull/push operations, git will attempt to automatically merge changes made by different authors. However, if both you and your partner have made overlapping edits, git will halt and report a "merge conflict". Git dumps both sets of changes into the conflicted file and fences the sections with marker symbols (>>>, <<<, ===). You must manually resolve the sections in conflict. To do this, open the conflicted file, look for the marker symbols, edit the contents to select one/other/both changes as you see fit and remove the symbols. Save the file and commit it to complete the merge.
Ensure that all team members are able to access the project repo and pull and push changes. Ask for help resolving any glitches!
Develop project plan, review with us
What aspect of computer systems will you explore? What hardware do you want to try out? How will you coordinate with your team to execute on your plan?
Brainstorm project options and refine those ideas into a specific project. Make a list of components/materials/tools you will need and figure out where you can get them, paying particular attention to shipping lead times. Breakdown the work into task areas and assign responsibilities to each team member.
One of the most important details for your propsal are the is a schedule of milestones to guide your work.- Enumerate midpoint milestones to hit by next lab (aim to resolve unknowns/risks sooner than later)
Grab an instructor or TA at some point during the lab and give a pitch for your project and to get our feedback on ensuring the project direction, scope, and schedule are aligned for a great outcome. Need advice on hardware, code, resources, strategy? Please ask!
Draft project proposal, submit
After checking in with us to confirm your plans are on track for a great result, work with your partner to draft your project proposal. See project writeup for instructions on what it to be included in the proposal and how to submit. Proposals are submitted at the end of lab or by end of day Thursday is you need a little more time.
Finishing
No Google form to fill out for this lab – your team's submitted project proposal serves as confirmation of your participation!