CS411W Outline

Spring 2024

1 Online Orientation and Course Introductions 01/06/2024 - 01/08/2024

Overview

This Module will serve as a review of CS 410 and an introduction to CS 411W. We will discuss the various, communication tools, hardware tools, and software tools for this semester.

Objectives

At the end of this module, students will be able to:

  1. Explain the course goals.
  2. Discern team member skills.
  3. Identify team development needs.
  4. Modify existing CS 410 documentation based on lessons learned.
  5. Investigate communication and collaboration tools and platforms.
  6. Establish mechanisms of communication and collaboration.
  7. Write a descriptive paper (Lab 1) summarizing the real world product and planned prototype development.

Relevance

The business and research communities provide require online communication and collaboration using asynchronous and synchronous tools. Students will function as effective members of geographically separated team by contributing to the development of a Docker based prototype on a CS Department provided virtual machine (VM).


  1. Syllabus
  2. Communications - General Guidance
  3. Introduction & Overview
  4. Personal Introduction Post
  5. Course Introduction (Fall 2020)
  6. Office Hours

  7. Complete the office hours survey

The Fun Part of Module 1 - Prototype Foundation

  1. Initial Website Updates
  2. Group Google Drive Folder
  3. Git Repo

General Lab Requirements & Expectations

  1. Incidental Skills
  2. Review Lab Formatting Rules
  3. Review Common Grammar & Style Mistakes
  4. Lab Rewrites & Grading

Lab 1

  1. Lab 1 Outline Updates & Review

2 Prototype Foundations 01/09/2024 - 01/29/2024

Overview

The work will begin on the prototype development environment. Teams must configure their virtual machines to support development. Development milestones will be revisited with a focus on defining subtasks for each milestone.

Objectives

At the end of this module, students will be able to:

  1. Identify and configure prototype development tools.
  2. Leverage domain appropriate collaboration & communication tools.
  3. Identify high level tasks with prioritization of CS 410 user stories
  4. Delegate and assign development tasks.
  5. Prepare a Gantt chart storyboard of milestones for prototype development.
  6. Complete Lab 1.

Relevance

We will leverage agile development to design and build a prototype. This is based around user stories that may change (usually do) along the way. The goal of this module is to confirm mentor acceptance of the development approach.

Lab 1 is representative of the type of descriptive documents students will be required to create in the workforce.


  1. Development Overview
  2. What is Collaboration?
  3. Introduction to Git

Prototype Milestones & Design

  1. Milestones, WBS, and Product Development
  2. Select Story & Issue Tracker
  3. Prototype Milestones & User Stories
  4. Prototype Demonstration I (Discussion)
  5. Prototype Structure - Overview

Lab 1

  1. Lab 1 Draft - Update Sections 1 to 3
  2. Lab 1 Draft - Update & Add Section 4
  3. Lab 1 - Version 1 (Working Draft)
  4. Lab 1 - Version 1
  5. Lab 1 - Version 2

3 Detailed Design 01/30/2024 - 02/26/2024

Overview

The goal of Module 3 is to prepare a detailed list of tasks necessary to complete each prototype milestone. The tasks will have associated timelines and resources. This will allow for the creation of a weekly “to do” list for the team and each individual of the team. Lab 2 describes and defines the specifications and requirements. The mentors should be actively consulted during this design process.

Objectives

At the end of this module, students will be able to:

  1. Identify sub-tasks for each milestone.
  2. Record and track sub-tasks with a Gantt chart, task board, story board, or issue tracker.
  3. Identify tasks that can begin immediately.
  4. Create a list of design/coding elements to be completed each week.
  5. Write in the style required for specification and requirement documents in the workforce.

Relevance

An absolutely critical component of software design is the writing of specifications and requirements. Also critical is the ability to provide software code based upon provided documents.


Development Schedule

  1. Milestone Tracking

Team Evaluation

  1. Group Evaluation I

Specifications & Requirements

  1. Specifications & Requirements
  2. Example Requirements from Previous Semesters
  3. Write A Requirement
  4. Revise requirement based on feedback

Lab 2

  1. Lab 2 - Requirements & Specifications (Individual Portion)
  2. Lab 2 - Requirements & Specifications (Group Portion)

Supplemental References

  1. IEEE RFC 2119 - Requirement Levels
  2. Bob Cherinka - How Computer Science Can Help You Solve Problems for a Safer World
  3. CS 350 - Eliciting Requirements
  4. CS 350 - Writing Requirements

4 Testing 02/27/2024 - 03/22/2024

Overview

Testing is notoriously given the least amount of time and attention in software development. You should recall Test-Driven Development (TDD) from your previous coursework. We are currently implementing prototype functionality, yet need to simultaneously prepare test cases for our requirements. Significant progress should be made on software development over the next four weeks. Each team will collaborate on an outline of Lab 3 (i.e., the Test Plan).

Objectives

At the end of this module, students will be able to:

  1. Maintain a Gantt chart, story board, or issue tracker of software development progress.
  2. Prepare industry standard test cases that verify and validate the requirements from Lab 2:
    1. unit tests
    2. integrations tests
    3. system tests
    4. acceptance tests
  3. Collaborate on the authoring of test cases and traceability matrices.

Relevance

Software development in industry is heavily dependent upon adherence to requirements. The only way to guarantee that the correct software solution to a problem has been achieved is through verification and validation via testing. If the test cases are not written to properly assess the development, time, money and credibility are lost. Possibly resulting in job loss and business failure. Students will experience the detailed process of this critical V & V element using their prototypes as the test bed.


  1. CS 263 - Testing
  2. CS 263 - Structure of a Python Program with Tests
  3. Implementation and Unit Tests
  4. Integration & Systems Tests
  5. Write a Test Case
  6. Revise test case based on feedback

Test Plan Examples

  1. 2020 Spring - Punctual
  2. 2020 Spring - The Modern Dog
  3. 2019 Fall - University Friend Finder
  4. 2019 Fall - Tutor Dash
  5. 2019 Fall - SeizSmart

Lab 3

  1. Lab 3 - Prototype Test Plan

5 Customer Interaction 02/27/2024 - 03/24/2024

Overview

The primary objective of this module is to practice agile (potentially scrum) development of the prototype with frequent instructor and mentor interaction. Weekly progress examinations will be conducted, and feedback will be provided. Adherence to requirements and development toward correct validation and verification is expected.

Objectives

At the end of this module, students will be able to:

  1. Collaboratively continue successful prototype development employing all necessary software tools.
  2. Collaboratively prepare a User Manual developed for the prototype.
  3. Interpret the writing style necessary for user manuals.
  4. Demonstrate correct adherence to user manual authoring standards.
  5. Effectively demonstrate the prototype to the instructor and mentor.

Relevance

The ability to effectively communicate the purpose of user interfaces is a part of software engineering. The ability to take the reader of a user manual step-by-step through the usage of the screen is a skillset needed in industry. If a user cannot understand the interface, they may not utilize the product. The process of interim reviews of software development requires unique skillsets:

  1. A developer must be able to professionally take criticism.
  2. A developer must be able to ask questions of the customer to deliver a product that solves a problem correctly.

Lab 4

  1. Writing a User Manual
  2. Lab 4 - User Manual

User Manual Examples

  1. Tutor Dash (Team Gold Fall 2019)

References

  1. Bookmark GitLab Markdown
  2. Read Five Tips for Writing a User Manual

6 Lessons Learned 03/25/2024 - 04/08/2024

Overview

This module guides the student to successful completion of all written labs (re-writes). Demonstrations will be necessary to gain approval of their mentor, which is required by the end of the semester. The goal is to provide each student with an appreciation of industry’s expectations upon graduation with a degree in computer science.

Objectives

At the end of this module, students will be able to:

  1. Summarize their journey through their professional preparation for employment.
  2. Summarize the successes and challenges of developing professionally written technical documents typical of computer scientists.
  3. Summarize their successes and challenges of working on a team to design, develop, and deliver a large scale software product.
  4. Deliver a working product to their mentor.

Relevance

At the end of every software development process industry members must conduct Project Postmortem. The goal is to repeat the aspects that were great, and avoid those that cost them time and money. Keeping on top of customer expectations is critical in providing a useful product that correctly solves the prevalent problems that necessitated the need for a software solution.


  1. Project Postmortems
  2. Product Delivery

Team Evaluation

  1. Group Evaluation (Final)

7 Semester Wrap Up 04/09/2024 - 04/20/2024

This Module is an end-of-semester wrap up. We will revisit selected topics from throughout the semester.


  1. Project Postmortem Report
  2. Final Prototype & Document Updates

8 Special Events and Dates

The ODU Academic Calendar lists all deadlines and important dates.

  1. Classes Start 01/06/2024

9 Postscript

All times in this schedule are given in Eastern Time.

Symbol Key
lecture Read:
slides Slides :
event Event or important date
text Read
lab Do lab:
asst Assignment:
exam Take the
activity Do:
recitation In your recitation section:
construct Under construction:

10 Presentation

Topics Lectures Readings Assignments & Other Activities
topics lecture slides event exam video project construct text exam asst selfassess exam activity lab
Document Kind Prefix
lecture Read lecture notes:
event
exam Take the exam:
lab Do:
asst Do assignment:
reading Read (optional):