Week 6 Class 12 Thu Oct 01 Posted: Oct 01
Before Class
If you haven't already created the GitHub Classroom repository for "Build Files" you should do so before class. You can also set up a GitHub Codespace for the project, as it takes some time to start up initially and when restarting.
Exercise 25: Build Tools Background
Please complete before class starts. There are no wrong answers, and not much to write.
Announcements
Project 1 I will allow you to earn some points back by correcting what you submitted. To count:
Class
Make
Build Files GitHub Organization Invitation Link - Create your own repository for this example (and future exercisese)
$@, $<, and $^srccomplexitybuild-files-f26-020 Example I will demonstrate with
Exercise 26: Makefile
Code along and make the same commits with the same commit messages as I do in class.
I suggest you use GitHub Codespaces as all necessary packages are installed.
Remember that you can access my commits as I make them.
Unless stated otherwise, all exercises are due by 4 pm on Mon Oct 05
Project 2 is due on Friday, Oct 9 at 11:59:59 pm. The GitHub Organization Project 2 Invitation.
For Project 2, take all the user stories from Project 1 and create a series of iteration plans.
Use the examples in the book to show which parts of the user story you should show in your iteration plan (e.g., do not restate descriptions in the plans). Also, clearly state the entire new iteration plan for each plan, not just the changes. However, make sure to thoroughly discuss what the change was and what effect it had.
This is an individual project. Each member of a team has different user-story priorities. To get individual priorities for Project 2, select the number of user stories:
Put these in the Priority field in the order in which you listed the user stories. In the report, do not discuss how you generated your report's priorities, i.e., pretend that the customer gave them.
The following plans may require you to add additional user stories. This violates our rule that only the development team can create estimates. However, as part of the exercise, put in an estimate.
Each plan is a point in time. For each plan, show the entire iteration plan, including the iterations already completed.
| Plan | Events |
|---|---|
| 1 | Create an initial iteration plan: 2 Weeks (14 calendar days) iteration, 2 developers, 0.6 velocity |
| 2 | The customer adds two new user stories of the highest priority at the end of the first iteration. For the two new user stories, one is a new feature, and one is an emergency. Create a non-trivial estimate (i.e., an estimate that makes the planning interesting) for these new user stories. |
| 3 | A user story with a non-trivial estimate takes twice as long. Assume this occurred right before the last iteration. |
| 4 | At the beginning of the last iteration of your current plan, the other developer leaves for another project, and it is up to you to finish the project. |
After the plans, create a section with all of your user stories, including their titles, descriptions, estimates, and priorities. You will need estimates for all of your user stories.
Your team completed the first iteration. Despite inexperience with determining estimates, you did complete the all the planned user stories.
For some of the remaining user stories, not part of the first iteration, the customer updated the priorities of 4 user stories. Get new priorities for these user stories:
Now, design a second iteration. Use the principles in the book to decide which of the remaining user stories belong in the second iteration.
Individually, each team member will turn in to Brightspace notes with the following:
Do not assume any dependencies between user stories.
The notes are due by the end of class. They can be a PDF (print to file from a computing device) or a JPG (picture taken via phone).
If you finish early, work on real estimates for your user stories.
Week 6 Class 11 Tue Sep 29 Posted: Sep 29
After Class
Exercise 25: Build Tools Background
Please complete before class starts. There are no wrong answers, and not much to write.
If you haven't already created the GitHub Classroom repository for "Build Files" you should do so before class. You can also set up a GitHub Codespace for the project, as it takes some time to start up initially and when restarting.
Announcements
I will allow you to earn some points back by correcting what you submitted. To count:
Project 1 Observations
UNIX Commands
I occasionally use UNIX commands in a bash shell to perform development tasks or to point out the results of development tasks. Obviously there is git, but there are a lot of other commands that we use. We just saw diff and patch.
I recommend that you keep a list of these commands with the name, short description, and example of using it. These commands will not be on any exam unless I specifically say they are. However, they may be part of a crossword.
Class
Demo: Patching Linux
Exercise 22: Patching Linux
Follow along with the Patching Linux demo shown in class. Write the commands in order as they are applied in the demo.
For the URLs, copy and paste, or write a shortened form of the URL.
Upload to Brightspace this list of commands. This can be a text file, or an image of the commands written on paper. This is due by the end of class.
Make
Build Files GitHub Organization Invitation Link - Create your own repository for this example (and future exercisese)
$@, $<, and $^srccomplexitybuild-files-f26-020 Example I will demonstrate with
Unless stated otherwise, all exercises are due by 4 pm on Wed Sep 30
As a team, create the first iteration of an iteration plan.
Ideally, we would have enough Team Meeting time to estimate all user stories using Planning Poker. However, we do not. To make up for this, I am providing estimates for the rest of your user stories. Enter the following:
Add these estimates to your user story cards.
The other missing item is the priorities. These come from the customer. To get priorities, select the number of user stories:
Add these priorities to your user stories.
You have 1 developer and a one-month iteration with a 70% velocity.
Use the principles in the book to decide which user stories belong in the first iteration.
Individually, each team member will turn in to Brightspace notes with the following:
Do not assume any dependencies between user stories.
The notes are due by the end of class. They can be a PDF (print to file from a computing device) or a JPG (picture taken via phone).
If you finish early, use planning poker for estimates on the user stories your team did not estimate earlier.
Week 5 Class 10 Thu Sep 24 Posted: Sep 24
Announcements:
Tasks
Class
Exercise 21: diff and patch
Write on paper the diff and patch commands of the two sessions, Creation and Application on a piece of paper as I show this in class.
Due after I show it in class.
Unless stated otherwise, all exercises are due by 4 pm on Fri Sep 25
As a team, take a user story that has an estimate, and create the tasks for that user story. Then, create the estimate for each task by playing planning poker using the procedure described on pages 48-49 of the book. Go through the estimation process at least one time.
When the team reaches a consensus for the estimate, place the estimate at the bottom of the task, e.g., "Estimate: 1 day" or "Estimate: 3 days".
Individually, each team member will turn in to Brightspace individual notes that include for each round of planning poker:
If the team cannot reach a consensus, table that task and go on to another one.
The notes are due by the end of class. They can be a PDF (print to file from a computing device) or a JPG (picture taken via phone). The notes are for today only. Do not start with the notes from the previous team meeting.
The more you work with the user stories, the more you will find improvements to them. Be sure to make those improvements.
Week 5 Class 9 Tue Sep 22 Posted: Sep 22
Announcements:
Class
Unless stated otherwise, all exercises are due by 4 pm on Wed Sep 23
As a team, take a user story that has an estimate, and create the tasks for that user story. Then, create the estimate for each task by playing planning poker using the procedure described on pages 48-49 of the book. Go through the estimation process at least one time.
When the team reaches a consensus for the estimate, place the estimate at the bottom of the task, e.g., "Estimate: 1 day" or "Estimate: 3 days".
Individually, each team member will turn in to Brightspace individual notes that include for each round of planning poker:
If the team cannot reach a consensus, table that task and go on to another one.
The notes are due by the end of class. They can be a PDF (print to file from a computing device) or a JPG (picture taken via phone). The notes are for today only. Do not start with the notes from the previous team meeting.
The more you work with the user stories, the more you will find improvements to them. Be sure to make those improvements.
Week 4 Class 8 Thu Sep 17 Posted: Sep 17
After Class
Announcements
Exercise 13: Commit to Project 1 Repository
Project 1: Requirements Report
Project 1 asciinema session The asciinema session is after you complete Project 1. Since you are still performing estimation, you are not done with the user stories for Project 1.
Estimates
Class
Unless stated otherwise, all exercises are due by 4 pm on Fri Sep 18
Start by reviewing your user stories, particularly the titles. Titles that do not have an action term, or have a poor action term, will reduce your score on Project 1.
As a team, create estimates for the user stories by using the planning poker procedure described on pages 48-49 of the book.
When the team reaches a consensus for the estimate, place the estimate at the bottom left of the User Story as indicated by the example, e.g., "Estimate: 1 day" or "Estimate: 3 days".
Individually, each team member will turn in to Brightspace individual notes that include for each round of planning poker:
If the team is not able to come to a consensus, table that User Story and go on to another one.
The notes are due by the end of class. They can be in the form of a PDF (print to file from a computing device), or a JPG (picture taken via your phone).
The more you work with the user stories, the more you will find improvements to them. Be sure to make those improvements. Also, you may think of additional user stories. Be sure to add them.
Week 4 Class 7 Tue Sep 15 Posted: Sep 15
Announcements:
Exercise 11: GitHub Username
There are three steps to allow you to create repositories for the projects and some of the exercises:
For 3, I indicated in your feedback for Exercise 11 if this was not accepted yet, then you need to accept the invitation
Invitations are email to the email account for your GitHub Username. I assume in most cases this is your UA email.
You can also view these on your GitHub Organization Page
If you accept the invitation, I will give you full credit for this exercise.
Windows File Explorer & WSL
To open the Windows File Explorer on the current directory in WSL:
The . means the current directory in WSL. You can also open a file explorer.exe Requirements.md. If you open a path it has to be in Linux format, e.g., C:\Users\JohnDoe\Documents would be /mnt/c/Users/JohnDoe/Documents.
Assumptions
I noticed that many of the assumptions mentioned are about the difficulty of implementation. This is not what the book discusses. Instead, they are assumptions about what the user story means. The only person who can answer those assumptions is the customer.
From now on, label assumptions about the user story as assumptions and assumptions about implementation as implementation.
Dependencies
I see a lot of user story estimates where the assumptions include the completion of a previous user story. This is a dependency. Avoid dependencies at all costs. For example, Add … does not have to be completed before Delete …. Obviously there will be some dependencies, but they are to be at the user-story level, not the implementation level.
Class
Exercise 13: Commit to Project 1 Repository
Following the procedure given in the assignment and demonstrated in class, contribute at least one commit to the Project 1 repository. This must be a valid and useful commit.
git CLI to make the commit. You can do this wherever you have the repository cloned. You can even do this in a GitHub Codespacegit commits:
You can see your commit messages with the git log command.
Unless stated otherwise, all exercises are due by 4 pm on Wed Sep 16
Your management is concerned that your team does not have a complete set of user stories. The first problem is low recall, i.e., the team is not capturing all the user stories the customer needs. The second problem is that without not enough work, the organization will have to let some of the team members go cut everybody's pay.
The customer met with their team and returned with a list of potential user-story titles. These possible new user stories fall into one of the following categories:
Each team member will fill out the form for your team. The form will not be available until your team meeting time.
Create a new user story, or multiple user stories, for each of these valid potential user stories. This includes fixing any title issues and adding a description. Also, take this time to fix any existing user stories.
If you have any additional time, then create more estimates. As you did before, keep track of details for the next team meeting when you will submit any estimate details.
There is nothing to upload for this exercise. Complete the provided form during class time.
Week 3 Class 6 Thu Sep 10 Posted: Sep 10
After Class
Exercise 11: GitHub Username
There are three steps to allow you to create repositories for the projects and some of the exercises:
For 3, I indicated in your feedback for Exercise 11 if this was not accepted yet, then you need to accept the invitation
Invitations are email to the email account for your GitHub Username. I assume in most cases this is your UA email.
You can also view these on your GitHub Organization Page
If you accept the invitation, I will give you full credit for this exercise.
Note that the link (in the title of this this notice) will only work if you:
Announcements:
Similar Action Words
Many action words are similar in meaning, but can vary in specificity or in details that they imply.
| Word 1 | Word 2 | Explanation |
|---|---|---|
| Delete | Remove | "Delete" often implies a permanent action, while "Remove" can be less final or reversible |
| Approve | Accept | "Approve" sounds authoritative, while "Accept" is more general |
| Invite | Connect | "Invite" is very specific, suggesting a request for participation, whereas "Connect" is broader |
| Create | Add | "Create" is making something new, whereas "Add" can mean including something that already exists |
| Subscribe | Register | "Subscribe" is ongoing engagement, while "Register" is often a one-time action |
| Approve | Validate | "Approve" is a decision or permission, while "Validate" suggests checking or confirming correctness |
| Merge | Link | "Merge" is combining into one, whereas "Link" connects them without combining |
| Submit | Send | "Submit" is submission to a process, while "Send" is transferring information |
| Stop | Pause | "Stop" is final, while "Pause" is temporary |
| Cancel | Stop | "Cancel" is preventing something from starting or finishing, whereas "Stop" is halting an ongoing action |
Note that the customer may not realize the difference between these terms, and say one when they mean the other.
Exercise 11: GitHub Username GitHub Classroom is no more. Instead, we are using Classroom 50. The process for allowing you to create a repository has changed and is as follows: 1) Add you to the UACPSC GitHub Organization, and 2) Add you to the roster for the course. To do so, I need your GitHub Username. If you don't provide it, you won't be able to do the projects and some exercises.
The title of this exercise is a link to the form where you can enter your GitHub Username.
Once I add you to the roster, you will receive an invitation to join the UACPSC GitHub Organization. You will need to join in order to create repositories. Note that this differs from the GitHub Classroom process of the past.
Due Friday, Sep 11 by 9 am.
Class
Unless stated otherwise, all exercises are due by 4 pm on Fri Sep 11
Project 1 is due Monday, September 21 at 11:59:59 pm, in the file Requirements.md in a GitHub Organization UACPSC repository. You will need a GitHub account, give me your GitHub Username, and accept the invitation to join the GitHub organization UACPSC. Once you are all setup, an invitation link to create the repository is in Brightspace.
At your place of work, you need to submit a formal report describing the project's current state. Write a report of your individual and team activities, including these primary sections:
1. User Stories
User Stories with title, description, estimate, and space for priority
This will be shown to the customer. This section should not contain any information that a customer should not see.
2. General Process
Details of the overall process and procedure that created the Estimates
This will be shown to the customer, so only data on the User Story cards from section 1 should be shown.
3. Background Data
Details on spread, assumptions, issues, etc.
How did the team interaction work, and what did and did not work well
This will not be shown to the customer. It is for your supervisor.
In other words, the report describes all the work and processes followed while creating the user stories and their estimates. The details of the general process and the general observations in Section 3 are in the form of a narrative, i.e., describe what you did, how you did it, and the result, ordered by time. The report's tone is professional, with a clear, consistent presentation.
The team created the User Stories and Estimates, but this report is an individual project. In your account, make changes to User Stories if they do not follow the guidelines given in the book. These changes are especially crucial for the Title and the Description. Split User Stories if the Estimate is too large. Explain any changes in your report.
The report uses plain-text formatting syntax Markdown. Markdown is an almost universal format for text formatting in software development. Due to its direct conversion to HTML, Markdown has replaced HTML and other plain-text formatting languages in SE. It has become so popular that it is a new document type in OneDrive.
You will use git to work on your report. Assuming a username of jdoe@uakron.edu, the steps are as follows:
jdoe@uakron.edu
Note: All commits must have non-blank commit messages. Any non-blank commit messages will not be accepted, leading to a 0 on the entire project.
A GitHub Codespace is available for this project. See the guide GitHub Codespaces.
After you have committed your final change to the project, you must run your report through a report check to see if it follows many of the Markdown requirements of the project. To do so, create a GitHub Codespace for the project. When in there, enter the command:
You should see a clean report. If it finds anything, fix it and rerun the checkmd command.
The checkmd is a custom command created for this project to verify specific Markdown requirements. A clean run does not mean you have nothing wrong with your project.
Upload an terminal session of your report successfully passing the checkmd program.
To demonstrate this, you will record a terminal session using asciinema. It records the commands you enter and the output the command produces. asciinema is already installed in the GitHub Codespaces image. You can also install asciinema on Linux/WSL/macOS.
asciinema is relatively straightforward to use.
Further Note I am removing the screencast requirement for Project 1
Note I removed the example screencast because it is for an old version of asciinema. Go to the asciinema site, or wait until Tuesday, Sep 22 when I will demonstrate it in class. The screencast URL due date is extended to 11:59:59 pm on Tuesday, Sep 22. The project due date remains the same.
You can play, pause, skip, etc. You can also copy the commands as text. Note that the replay even includes your pauses and any delay as the command is run.
At the end of the terminal session, asciinema will show a URL. Anybody can use this URL to view the session. This is what you will submit for the exercise to the link in the exercise title. The URL should not contain "connect" or be a local file. Test your URL in a browser; an incorrect URL will receive a 0.
Submit the URL via this form: Project 1
The report content, format, and involvement in team activities are all considered for your score.
Think carefully about how you present the report, including using Markdown. Remember, the User Stories form an unordered set, not an ordered list.
Start by reviewing your user stories, particularly the titles. Titles that do not have an action term, or have a poor action term, will be counted off on your score for this exercise.
As a team, create estimates for the user stories by using the planning poker procedure described on pages 48-49 of the book.
When the team reaches a consensus for the estimate, place the estimate at the bottom left of the User Story as indicated by the example, e.g., "Estimate: 1 day" or "Estimate: 3 days".
Individually, each team member will turn in to Brightspace individual notes that include for each round of planning poker:
If the team is not able to come to a consensus, table that User Story and go on to another one.
The notes are due by the end of class. They can be in the form of a PDF (print to file from a computing device), or a JPG (picture taken via your phone).
The more you work with the user stories, the more you will find improvements to them. Be sure to make those improvements. Also, you may think of additional user stories. Be sure to add them.
Week 3 Class 5 Tue Sep 08 Posted: Sep 08
After Class
Exercise 11: GitHub Username GitHub Classroom is no more. Instead, we are using Classroom 50. The process for allowing you to create a repository has changed and is as follows: 1) Add you to the UACPSC GitHub Organization, and 2) Add you to the roster for the course. To do so, I need your GitHub Username. If you don't provide it, you won't be able to do the projects and some exercises.
The title of this exercise is a link to the form where you can enter your GitHub Username.
I am posting this early since the deadline is earlier than normal. Due Friday, Sep 11 by 9 am.
Announcements:
Action-Oriented Titles
The primary goal of user stories is to capture a specific need or goal of a user in the context of software development. It's about "what the user wants to do" or "achieve" with the software.
Benefits of Action-Oriented Titles:
User Story Titles and the Number Grammatical Category
Strongly consider using a title with a singular noun for a user story, instead of a title with a plural noun, because it emphasizes the atomic nature of the action.
| Plural | Singular |
|---|---|
| Upload Documents | Upload a Document |
| Send Messages | Send a Message |
| Add Products to Cart | Add a Product to the Cart |
| Register for Events | Register for an Event |
| View Notifications | View a Notification |
| Search for Jobs | Search for a Job |
In general, user stories with singular titles are going to be easier to implement. There can be exceptions, as "View Notifications" may be simpler than "View a Notification" due to not having to select just one.
The most important aspect is clarity and understanding. If "Purchase Clothes" effectively communicates the intent without ambiguity and your team finds it more natural, it's also acceptable. The choice between singular and plural should ultimately be guided by what best serves the clarity and focus of the story in your context.
Class
Unless stated otherwise, all exercises are due by 4 pm on Wed Sep 09

Your team is to correct the current user stories and increase the number of user stories. Very carefully go over your user titles and descriptions. Add more user stories and see what you are missing.
The number of user stories per teams was 7, 9, 11, 12, 16, 16, 16, 17, and 27(!). Twelve and under are far too few. Greatly increase the number.
Remember to split any user stories that you can. Apply the "and" rule.
In addition to the team work of extracting user stories from the app description, each team member will turn in to Brightspace individual notes that includes:
The individual notes are due by the end of class uploaded to Brightspace. They can be in the form of a PDF (print to file from a computing device), or a JPG (picture taken via your phone).
Do not upload a photo of all your user stories This will result in a very low score for the exercise. Follow the directions for the individual notes.
Week 2 Class 4 Thu Sep 03 Posted: Sep 03
Announcements:
Class
Exercise 7: HFSD Chapter 2 p42 User Story Interview
Unless stated otherwise, all exercises are due by 4 pm on Fri Sep 04

Each Team is assigned a separate App with the description in Brightspace.
As a Team, create as many User Stories as you can for that app from the app description. For now, this is just the Title and the Description. The Title is just an action that a user can perform. The Description is from 1 to 3 sentences that describes what that action is. Follow the examples given in the book.
The User Stories are written on the provided index cards. I will provide a folder for you to put the cards in as I will collect the cards at the end of class.
In addition to the team work of extracting user stories from the app description, each team member will turn in to Brightspace separate, individual notes that include:
The individual notes are due by the end of class uploaded to Brightspace. They can be in the form of a PDF (print to file from a computing device), or a JPG (picture taken via your phone).
Week 2 Class 3 Tue Sep 01 Posted: Sep 01
Announcements:
Exercise 3: App Idea I posted scores and feedback in Brightspace
View your feedback even if you got a 10 / 10. In some cases, a 10/10 does not mean there was nothing wrong.
Fix any issues that I identified.
If you fail to fix your issues or view your feedback by 4 pm on Wed Sep 02 I will change your score to a 0
Note: This "fix your issues and get full points" is not the norm for the exercises and assignments in the course
Class
Exercise 5: HFSD Chapter 1 Crossword
Unless stated otherwise, all exercises are due by 4 pm on Wed Sep 02
Form a team of 4 members. The final team composition is at the discretion of the instructor.
After forming a team, your team needs to decide on a name from the following choices:
Pick at least 4 names.
Send Dr. Collard and Mr. Cowan an email with the following:
CPSC480-020 Teammembers.csv, in the CSV (Comma-Separated Values) format. Use the following as an example:
Firstname,Lastname,Email,Section,Team
John,Doe,johndoe@uakron.edu,020,Harpo
Jane,Doe,janedoe@uakron.edu,020,Harpo
Brian,Doe,briandoe@uakron.edu,020,Harpo
Suzy,Doe,suzydoe@uakron.edu,020,Harpo
Harpo
Moe
Yoda
Zeppo
The purpose of a team is not just to divide the work but also to meet a required level of quality. All members of the team must check any team assignment in this course. You, as a team, are responsible for these directions. Any emails sent as part of an assignment (including exercises) must have the correct subject, CC list, and contents. Exercises are not accepted and do not receive points if they do not have the proper form and content.
The exercise is due by the end of class.
Week 1 Class 2 Thu Aug 27 Posted: Aug 27
Announcements:
Syllabus Missed section on prerequisites.
Prerequisites: Minimum C- in CPSC 210 Computer Science II
Since the prerequisite course is in C++, we will also use C++.
Class
Exercise 3: App Idea - Submit via Brightspace in PDF. Due by 4 pm on Mon Aug 31
All applications start with an idea or a need. As a user, write a description of an application. The description should include who would use it and its features. The application can be one that you create yourself or an existing program.
Guidelines:
Comments:
Unless stated otherwise, all exercises are due by 4 pm on Fri Aug 28
Week 1 Class 1 Tue Aug 25 Posted: Aug 25
After Class
Announcements
A comprehensive overview of all phases of software development, including requirements, analysis, design, implementation, testing and validation, release, maintenance, and evolution, focusing on agile methodologies.
Exercises
Exercise 2: Software Development Diagram
Draw the Software Development Diagram that I present in class. Upload a PDF or JPG through Brightspace.
All exercises are due by 4 pm on Wed Aug 26
Greetings and welcome to CPSC 480 Software Engineering (SE) section 020 for Fall 2026.
See you on Tuesday, Aug 25 at 3:30 - 4:45 pm in Arts & Sciences (CAS) room 134