Overview

Successful software projects require more than just technical expertise. Figuring out what the client wants, collaborating in a team, managing complexity, mitigating risks, staying on time and budget, and determining, under various constraints, when a product is "good enough" to be shipped are equally important topics that often have a significant human component. This course explores these issues broadly and covers the fundamentals of modern software engineering and analysis.

This course focuses on software engineering and analysis. At a high level, the course is organized around five core topics:

A culminating assignment involves making a contribution to an open source project: identifying an issue, understanding the local development process, and then actually fixing a bug or adding a feature, with extra credit awarded if your contribution is merged into the project.

This course draws inspiration from Carnegie Mellon's Foundations of Software Engineering (15-313) course as well as from the insights of Drs. Westley Weimer, Kevin Leach, Prem Devanbu, Christian Kästner, Marouane Kessentini, and Claire Le Goues.

Attendance

This course is delivered in person. However, due to COVID, the guest lectures will be delivered remotely. We are also open to potential changes (e.g., if the instructors are tested positive for COVID). Recordings of lectures are available for students who are in quarantine.

Live attendance at the lectures is required and significantly contributes to the participation portion of the course grade. Students with extenuating circumstances, such as certain medical conditions or SSD accommodations, should email both the instructor (yu.huang@vanderbilt.edu) and cs4278Staff@gmail.com with documentation. Regretfully, time conflicts with other courses or jobs cannot be accepted.

Lecture recordings will be available via the course Piazza.

To encourage you to keep pace with the material, we will randomly assign quizzes for some lectures. These quizzes may consist of (1) comprehension questions about that day's readings, (2) questions about that day's lecture materials, (3) a 4-sentence summary of that day's lecture, or (4) a random code word shared during the lecture. Students will submit such quizzes in class (bring papers and pens). The goal is to encourage engagement and retention.

The course schedule is available in advance so that you can plan accordingly.

Technical Difficulties

If the autograder.io or Brightspace assignment websites are inaccessible to all students for a short time, all due dates and times remain unchanged (plan ahead!). If they are down for a longer period of time, the course staff will likely extend the deadline slightly and post a notification to that effect. We will make such determinations on a case-by-case basis.

If the main course webpage is inaccessible to all students for a short time, all due dates and times remain unchanged (It is hosted by the Institute for Software Integrated Systems (ISIS) at Vanderbilt, not by the professors personally). If it is down for a longer period of time, the course staff will likely extend a deadline slightly and post a notification.

If the course staff are unable to deliver a lecture/office hour at the scheduled time , no live participation grades for that lecture will be counted. For rare cases, if the lecture has not started within fifteen minutes of the scheduled time, you may consider it canceled (though we will try our best to post a notification in advance). The course staff will post a notification and deliver the lecture later. No attendance will be taken at that make-up time, and the lecture recording will be made available.

If you are unable to attend one or more lectures due to personal situations and technical difficulties, just send an email to us at cs4278staff@gmail.com so we can address it.

However, all the technical issues in the home assignments/projects (e.g., your VM does not work; you don't know how to use bash) will not be considered for deadline extenstions. In fact, it is the students' responsibility to address such issues as part of the assignments :)

With these policies, we are attempting to strike a balance between being as supportive as possible of students and holding students to resonable standards of preparation and accountability. We may revisit these policies later in the semester if there are extenuating circumstances.

Technical Elective

This course is an upper-level CS technical elective and one of the three CS DEPTH courses for undergraduate students. It is also a course for graduate students (i.e., CS5278).

It is not a capstone course or a major design experience course. It focuses on individual mastery of key software engineering concepts. It does not feature a large team project.

The expected workload for this class is "moderate" — one notch harder than an "easy" class in the CS departemnt, but two notches easier than a "hard" class in the department.

Reading and Comprehension

We do not require purchasing an expensive textbook for this class. Instead, we have carefully curated a number of freely-available readings associated with each lecture. You can view the required readings for each lecture on the lecture schedule.

Because software engineering is often more engineering than science, the basic concepts are often easy to grasp but the trouble is found in the details. Questions such as "which of these methods works best in the real world?" and "what are successful companies actually doing?" are paramount. As a result, many of the readings are experience reports from companies (e.g., Microsoft, Google, etc.) or academic papers (e.g., with human studies). These detailed readings serve to flesh out high-level concepts that can otherwise be introduced via Wikipedia without costing you money.

The readings will help you understand the lecture material, prepare you for the quizzes, and prepare you for some exam questions. Please expect to complete the readings before the associated lecture.

Finally, you may notice that some of the readings are marked optional. Next to each such optional reading I have included a small "advertisement" for why you might want to take a look. The optional readings are not required for any class assignments, but there may be extra credit questions on exams or quizzes that reference them.

Participation, Quizzes and Grading

You are expected to be present in lecture (checked by quizzes) and respond to in-class questions. If you are excused by the staff from attending live lecture, we will make alternate grading arrangements (e.g., your final score may be computed out of 95 instead of 100 or similar). For each in-class quiz, you will have around 5 minutes to finish it on a piece of paper.

Homework Assignments

There are seven homework assignments for this course. HW0-5 are the same for undergraduate and graduate students. HW6 is set up differently for undergraduate and graduate students, but both vesions require students to start early. Students have the HW6* option as the extra-credit assignment. The assignments involve the electronic submission of artifacts. Some (e.g., test cases) are graded automatically and admit immediate feedback. Others (e.g., prose descriptions) are graded manually. For certain assignments it is possible to work as a team.

Grading and Examinations

There are two exams during the semester. Both are delivered in-person (we may change it to remote depending on COVID situation and school policy). The grading breakdown is as follows:

Regrade and Makeup Policy

Regrade requests for exams, assignments, or written assignments must be received within one week of you receiving your score unless otherwise specified. All regrade requests should be made via Brightspace (if a request absolutely cannot be made via Brightspace for a certain assignment, please submit it privately on the course forum). When we regrade an assignment we will look over it very carefully for correctness: it is possible that after a regrade you will end up with fewer points than before the regrade. Regrades should be treated with caution and used only when the graders have made a clear mistake evaluating your work.

If you miss an assignment deadline or in-class activity, we can be very lenient about extensions or makeups, but we must have some amount of documentation for accounting and student equity. For example, a doctor's note or discharge note if you are sick. This policy follows that of other professors in the department. Please email me at yu.huang@vanderbilt.edu and the course staff at cs4278staff@gmail.com to submit documentation and/or discuss our particular situation.

Late Policy: If you miss an assignment deadline without an approved, documented extension, you may receive no points for that assignment. In some case, you may elect to receive h% off, where h is the number of hours late the assignment was submitted. No late submissions will be accepted after 4 days (96 hours).

The dates for the in-class examinations are posted well in advance. To request a rescheduled examination (e.g., for reasons other than a documented one as above, etc.), you must notify us via email at cs4278staff@gmail.com (privately) at least one week before the date of the examination. We cannot guarantee that we will accommodate alternate exams. If you miss an exam for a documented extenuating circumstance, we may consider doubling the contribution of the other exam, or we may find some other resolution at the instructor's discretion.

All course materials submitted for a grade must be turned in by midnight (Central Time) on the last date listed on the course syllabus.

The Waitlist, Course Permission, Overrides

Historically (including the few weeks since I started at Vanderbilt!), the single most common student question about this class relates to the waitlist. The question is some variant of (or logically reduces to) "I am currently on the waitlist; am I likely to get in to the class before the deadline?"

• If you are on the waiting list or add the course late (and you are definitely waiting for an opening to enroll), you must complete any assignments and bring me any forms (if any is required by the university) as if you were a registered student.
• If you add late or come in off the waiting list, all of the assignments are due for you at the usual time, with no extension.
• If you are on the waiting list and do not have access to the Autograder or Brightspace submission websites, please email the course staff.
• It is my firm intention to fill the class up to the enrollment limit with students from the waiting list.
• If you are on the waiting list or add the course late but need it to graduate in time, please talk to your academic advisor, confirm the situation and email me. At the same time, all of the assignments are due for you at the usual time, with no extension.
• Regardless of your enrollment status, you are welcome to sit in on the class. Anyone who is interested may attend the lectures. You can ask to join the Piazza by emailing yu.huang@vanderbilt.edu and cs4278staff@gmail.com.

Student Mental Health

Students often experience strained relationships, increased anxiety, alcohol or drug problems, feeling down, difficulty concentrating, family issues, or a lack of motivation. Student mental health concerns are quite common but we don't always talk about them. Vanderbilt Univeristy is committed to advancing the mental health and well-being of its students. If you or someone you know is feeling overwhelmed, depressed, or in need of support, confidential mental health services are available on campus.

Research

Your class work might be used for research purposes. For example, we may use anonymized student assignments to design algorithms or build tools to help programmers. Any student who wishes to opt out can contact the instructor or teaching assistant to do so after final grades have been issued. This has no impact on your grade in any manner.

Students interested in undergraduate research should make an appointment with me to talk about it. I am happy to discuss about independent studies, VUSRP, SUGRE, paid research work over the summer, research work for credit, and graduate school applications.