Setting up Team NOTES repo, dividing up LTD paper sections

Please sit in teams in Phelps 3525.

It will be up to each team to claim a table.

List of Team Assignments: https://bit.ly/cs156-f22-teams

Last Thursday in lecture:

Today’s Team Activity

This activity works with the paper that you were assigned to read:

You do not need to have read the whole thing for today, but you need to have at least skimmed it.

Our focus will be Section 4, which is divided into 6 sections:

Section Title Academia Industry
4.1 What: Differences in Scope well-defined, fixed scope vague, open-ended, evolving scope
4.2 When: Short vs. Long Time Spans short time spans (days, weeks) long time spans (months, years)
4.3 Who: Individual vs. Large Team individuals, pairs, small groups larger teams
4.4 Why: Learning vs. User Needs to learn something to address a user need
4.5 How: Ad-Hoc vs. Professional ad-hoc tools and practices professional tools and formal practices
4.6 How Big: Small vs. Large Codebases small programs large complex systems

You’ll first assign one person from your team to each section; most teams have six people, so that’s team member per section.

You might use the team slack channel, and use first-come, first-served, or some other way to divide up the sections.

If one or more team members is absent, put a slack message in your team channel mentioning them by @-ing them, and letting them know which section(s) are left to be claimed.)

(While I don’t think this applies today, because no one has dropped the course,if someone does drop before this activity is completed, as as a result, you have fewer than six team members, you can decide to leave one section uncovered.)

Then, please choose one member of the team as the team scribe (preferably, a different one from last time) that can share their screen.

That member of the team should go to the repo for your team on GitHub. Here are links to these repos:

5pm 6pm 7pm
f22-5pm-1-NOTES f22-6pm-1-NOTES f22-7pm-1-NOTES
f22-5pm-2-NOTES f22-6pm-2-NOTES f22-7pm-2-NOTES
f22-5pm-3-NOTES f22-6pm-3-NOTES f22-7pm-3-NOTES
f22-5pm-4-NOTES f22-6pm-4-NOTES f22-7pm-4-NOTES

That should currently be an empty, private repo, accessible only to the course staff and the members of your team. The scribe, when they bring up the repo, will see something like the image shown below. Click on the README link to create a README.md file:

click to create README

Then, your screen will look something like the image below:

new README

What content should you type? Type a list of who is assigned to each section, something like this (you can copy/paste this, then edit it for your group)

The heading should look like this: # Notes from p01

# Notes from (date)

Paper Section Assignments:

* 4.1: Alice Z.
* 4.2: Bob Y.
* 4.3: Chris X.
* 4.4: (unassigned)
* 4.5: Danny W.
* 4.6: Emily V.

Then, save the file. This first part is worth 20% towards your group participation grade; each person assigned to a section earns this if/when this gets committed to GitHub.

Each person now creates a file for their section

Next, each member of the team (individually) should create a file pertaining to their own section. You can do this by following the instructions/images below.

Note: Please follow the naming conventions shown below STRICTLY, including upper vs. lower-case letters.

First, find the “Create New File” button:

Create-new-file-50.png

Then, start typing the folder name p01, as shown.

As soon as you type the forward slash /, you should see that the filename turns into a folder name.
If you have made a typo, you can hit the delete/backspace key, and it should go back so you can edit the folder name. (The screenshot shows 10.06 as the folder name; please use p01 instead.)

start-typing-folder-50.png

after-typing-folder-50.png

Finally, name your file as shown in the example, and fill in content as shown in the example. For now, we only need the heading; the content can come later. The folder name should be p01 and the file name should be one of these: sect4.1.md, sect4.2.md, sect4.3.md, sect4.4.md, sect4.5.md, sect4.6.md.

(The screenshot shows 10.06 as the folder name; please use p01 instead.)

fill-in-section-heading-50.png

You earn 50 points towards the individual part of today’s participation when you create your individual part of the repo. You only need the heading; no content yet, that’s for Wednesday.

Now read over H03:

This is your homework H03 for next Wednesday, 10/05:

You don’t necessarily need to do it right now, though if you have time during today’s discussion section, you might as well get started.

But at a mimimum, please read over it and make sure you understand it; if you have questions, ask.

What happens after today’s class?

For lecture on Thursday , please be prepared for a full discussion of the paper. There will be more questions to answer then.

Checklist for today’s work

  1. Double check that someone on the team has set the README.md of your team’s f22-xpm-y-NOTES repo to have the correct content (list of who is assigned to which section, with a heading of# Notes from p01

  2. Double check that each member of the team that’s present has create a file in that repo under a folder called <p01 with the correct content (a file that’s one of (sect4.1.md, sect4.2.md, etc.) and that the content of that file matches the instructions above. It only needs to be a header at this point.

What then?

And you can also get a headstart on: