1.1 Course Pre-requisites

2 Course Structure

2.1 Sessions

• Lectures: online - no meeting times
• Recitations:
  • Tues 3:50pm-5:50pm (selected weeks)
  • Thurs 3:50pm-5:50pm (selected weeks)
  Lecture materials for this course will be available on-line, primarily in printed/text form.

2.1.1 Recitations

Recitations will be used for special topics and for meetings with teams once the semester project is underway.

• They will not meet every week.
• Meetings will be on-line.
  • You will attend from your “development machine”.

2.2 Review Recordings

I provide recorded Reviews on the course site. These are, in general, condensed versions of what would traditionally be live lectures. This includes:

3.4 Semester Project

A moderately large program on which you will work in teams of 4-6 people.

Four phases:

1. Writing Requirements
2. Planning for construction: writing user stories
3. Early construction: build management, version control, story tracking, project website
4. Later construction: documentation management, continuous integration, system testing

• In general, your team will be evaluated upon process as much as upon their ability to produce working code.

  The idea is to see if you have established a team process such that, if you had enough time, you would have eventually implemented the entire process.

• The team score will be modified for individuals based on evidence of teamwork.

3.4.1 Project Teams

• Teams will be assigned randomly.
• Each Team will draft a contract defining their expectations of acceptable participation.
• There will be options for voluntarily leaving a team, and for being fired from

• You will choose your own teams for the remaining phases

  • Must be members of your recitation section.

3.4.2 Project and Recitations

The construction phases (starting with Phase 3) will be evaluated in part via one or more team meetings with the instructor.

• Held during recitation period
• The instructor will ask questions about team’s overall progress.
• The instructor may direct questions to specific team members to be sure that everyone shares an understanding of the project and required skills.

  • General rule is that if one member of a team does not know something, that’s a mark against that person. If two people don’t know something, that’s a mark against the entire team.

• At end of some meetings, you may receive a short test/assignment, which each team member must complete individually within a limited time period (a day or less).

3.4.3 Expectations

The team project is a integral part of this course.

• Students are expected to actively participate in and contribute to their teams.

  • This engagement with the team will be part of the grade.

• Procrastination and deadline-brinkmanship are detrimental to any team dynamic.

  • Students who work early and often will be rewarded.

4 Exams

• Midterm & Final
  • Administered on-line
  • Dates & times on the course calendar
• Final exam is cumulative.

5 Communications

Contact Info

Important: The course name “CS350” should appear in the subject line of all course-related email.

I try to respond to all (properly marked) messages before I leave campus each day (Monday through Friday). On weekends and holidays within 48 on weekends & holidays.

Forums are also available on Canvas for general discussions.

5.1 Office Hours

5.2 Course Forums

• the Hallway
  • for general discussion of course topics
    • no discussion of assignment solutions!
• the Janitor’s Closet
  • reports of site issues, broken links, missing or incorrect web pages, etc.

6 Changes

7 Important Policies

7.1 Late Submissions

… are not normally accepted. Exceptions may be made in cases of

• documented emergencies
• arranged prior to the due date when possible.

Extensions to due dates will not be granted due to

• difficulties “porting” from one system to another
• transient system crashes
• system overloaded

7.2 Academic Honesty

ODU is governed by a student honor code.

8 Course Themes

Questions

• What is “Software Engineering”?

  • What is “Engineering”?

  • Is there “engineering” in software development?

8.1 Goals

• Look at best practices from the open source world.
• What are the tools and techniques that developers use on a daily basis?
• Automate best practices.
  • Make it more trouble and more time consuming to do things wrong than to do them right.

8.2 Areas of Emphasis

• Teamwork
• Test-Driven Development (JUnit)
• Build Management (Gradle)
• Version Control (Git)
• Configuration Management (Gradle, JCenter)
• Documentation Management (Javadoc, PWD, JBake)
• Continuous Integration (AWS)

8.2.1 Teamwork

• Reaching and recording agreement
• Collaborating without conflict.
• Visibility & communication

8.2.2 Test-Driven Development (TDD)

Exemplified by the philosophy of “write the tests first, then design and write the code.”

This is easily justified when fixing bugs. You need to have a test handy that shows the bug causing the program to fail, so that you can run it (again and again) while you try to fix the bug. How else will you know that you have it fixed?

But test-driven development is really about how to do the initial design. Programmers are often lazy. If they write the code first, they often skimp on the testing because that seems like too much work for code that they are “sure” is correct. (Remember, all programmers are optimists – they always believe that their code is going to work “as soon as I fix this one bug”. The combination of unjustified optimism and laziness can be deadly!)

But if the tests are already there, and if it’s easy to run them (or, even better, hard not to run them – I’ll talk about that in just a moment), then programmers will actually do the testing on a regular basis.

And thinking about tests for special/boundary cases, etc., often helps you remember those cases when later doing the design and coding.

8.2.3 Build Management

Making sure that you and others can build the system easily.

• A good build manager will not only compile and link the source code…

• It will also run the tests

  • making it more difficult to not test after every change

• and update the documentation and reports

  • again, actually requiring the programmer to work harder to let these things get out of sync than to keep them up to date

8.2.4 Version Control

The ability to track changes in the software.

• Avoid accidents
• resolve conflicting changes
• Explore ideas, then discard ones that turn out to be undesirable

8.2.5 Configuration Management

• How do we cope with importing third-party libraries that are themselves changing and have version depencies among themselves?
• How do we cope with dependencies of our own software upon the underlying platform?

8.2.6 Documentation Management

• Integrating documentation into the development process,
  • minimizing the “chore”.

8.2.7 Continuous Integration (CI)

• Offloading repetitive & time-consuming activities to remote servers.
• Set up and manage a CI server on Amazon Web Services (AWS)