<p>Your students do not know how to engineer software. They have not been taught. Teach them. (Suggest you find out what their syllabus has been &amp; what they actually learned.) You do not know how to acquire software. You have been burned. The solution is the same: software engineering. You must be the engineer of your desired software. A software client must be a software manager. You just didn't realize that you assigned yourself a software engineering project.</p>

<p><a href="https://cacm.acm.org/magazines/1981/2/10949-the-emperors-old-clothes/pdf" rel="nofollow noreferrer">The Emperor's Old Clothes</a>:</p>

<blockquote>
  <p>At last, there breezed into my office the most senior manager of all, a general manager of our parent company, Andrew St. Johnston. I was surprised that he had even heard of me. "You know what went wrong?" he shouted--he always shouted--"You let your programmers do things which you yourself do not understand."</p>
</blockquote>

<p>The core of the solution is the same: milestones. (Which, taking a module to be a unit of work, is just information hiding yet again as the foundation of software engineering.)</p>

CC BY-SA 4.0
2018-10-11T05:00:26.920Z
2018-10-11T05:00:26.920Z
philipxy
<p>Sorry, but digging in your heels or telling the students to wake the hell up is going to get you exactly nowhere. When a small percentage of your students fail to successfully complete a project it is likely their own lack of background or application. But when only about a third are able to successfully complete it, it is a problem with the course, not with them. </p>

<p>Some possible reasons for the problem. Perhaps they started late on it and weren't able to do a good job as user Adam asked? If so, why was that? Are they overworked generally in your course and elsewhere? I doubt that so many are just late starters. Was it a problem of insufficient testing? Was it too many tried a brute force approach that doesn't scale? How much does the course stress that early on - both testing and scaling? It seems like they weren't able to ask questions (of the TAs at least) as the project progressed. If they get stuck, how do they get unstuck? Just on their own? </p>

<p>I think you have a problem and I can't diagnose it, but you can. You can, for example, have your TAs do a postmortem with small groups. I hope you have more than one or two for 200+ students. The first question I would want the failed students to answer was "Were you surprised by the failure?" That can lead to a lot of discussion about the nature of it. I would ask about how much testing they did, especially on large sets. Were they able to use the tester effectively, providing appropriate inputs, or were they misled by it. Another question I'd want an answer to is how many students now actually know why they failed. What was it in the code or its creation that led them to failure. If they don't know that you have a serious problem going forward. I think that for these and similar questions your TAs are better able to get you usable answers. The students are less likely to feel intimidated by the questions than if you ask them directly. </p>

<p>On another level, I'd ask how many independent runs did you do with each student's work? Just one? The data was random, remember. Maybe naive inputs to the tester gave them poor feedback while doing their own testing. </p>

<p>Maybe a five week project with little guidance or feedback is sub-optimal. Especially if you treat it as an exam. It seems like a lot of time, until it isn't. Why not shorter projects? Why not more feedback? Why not, to be honest, continuous feedback? </p>

<p>I wonder how many students who failed did so only for run time and how many weren't even able to put together an algorithm at all. Has anyone given them feedback on their code and approach other than "failed"? </p>

<p>Are your expectations about what they "should have learned" in the earlier courses realistic? Are you making assumptions not warranted by the facts? </p>

<p>Don't just stamp your feet. Find out why this happened and change your teaching structure accordingly. Treat it like a scientific problem with an engineering solution. </p>

CC BY-SA 4.0
2018-10-09T20:50:52.910Z
That postmortem is a great idea. I will definitely instruct my TA's to do that in the next week's lab.
Ilkka Kokkarinen
CC BY-SA 4.0
2018-10-09T21:21:59.947Z
I saw situations like this in a college course I took in 1984: many students befuddled and unable to develop a working algorithm. We had no automated testing system, and limited access to computer terminals (mainframe environment). As you say, the info about *why* submissions failed is vital to figuring out the OPs problem. Coaching the students in incremental build and test would be valuable.
Scott Rowe
CC BY-SA 4.0
2018-10-11T15:15:11.173Z
One other potential issue I would add to this answer, somewhat related to the five week issue, is that they just can't fathom the steps necessary to break this problem down. I see this all the time in my CS1 and CS2 courses, even for less complex problems. I would either draw out a suggested timeline (e.g., "complete X method by Friday, Y method by Monday"), or have a check in at some point in time. Depending on the number of TAs you have, you could set up gitlab or something similar for students to check in their code periodically, and the TAs to assess whether they are making progress.
cryptic_star
CC BY-SA 4.0
2018-10-09T17:55:16.987Z
2018-10-11T15:46:40.357Z
2018-10-11T15:46:40.357Z
Buffy
<p>This answer is a complement to Buffy's and is more oriented towards future applications of autograding.  </p>

<p>The description of the assignment gave me the impression that your autograder is rather lazy. Instead of checking whether the functions the students have written are correct it executes a bunch of operations and compare a checksum of the result. Although this does check if the code is correct, it only produces <strong>right</strong> or <strong>wrong</strong> diagnostics. A small error like using <code>&lt;</code> instead of <code>&lt;=</code> is undetectable by this method. In other words, the autograder helps you (the instructor) to detect problems in the code, but it does not help students to understand their mistakes. </p>

<p>I prefer using autograders that behave more like unit testing. They go through all functions of the class students defined and test inputs and outputs. If there is something wrong it prints a nice message stating where it fails, for which input and lists current output and expected output. You can still grade only for correct solutions if you want to, but students get much more feedback on their progress. You also get more information about their performance and can see where the failing students made mistakes they could not figure out how to correct. You can even publish a set of "simple" tests and require students to write tests for tricky cases. IMHO this is a much more "modern" approach to grading and it has the added benefit of getting students used to software testing. </p>

<p>If you are not convinced by the argument above, let's explore a more technical perspective. A class is, essentially, a contract that says that a certain number of methods will behave in a certain way. How these methods are implemented should not be of concern to the caller (at least in term of correctness). In this situation, checking each method for correction is a very reasonable approach. It also allows for partial credit: a student that implemented some methods correctly deserves a better (but maybe still failing) grade than a student that did not implement a single method correctly.</p>

CC BY-SA 4.0
2019-10-11T14:06:20.083Z
2019-10-11T14:06:20.083Z
igordsm
<p>Late answer: I agree greatly with @igordsm's response above (emphasize unit testing with more detailed feedback, not just a "pass/fail" output), so this should be considered in support of that.</p>

<p>I agree with the comment by @pojo-guy that the specification seems "unnecessarily convoluted and artificial". Having read the specifications for the 1st and 4th projects, the tone also seems a bit snarky in a way that I would not recommend. Have the specification run 5 or 6 pages seems pretty long to me.</p>

<p>But the main thing is that I would recommend you consider changing your grading policies, as several of the terms seem poorly considered. E.g.:</p>

<ul>
<li><p>First, the whole idea of a binary auto-grader with a checksum output seems to have a bad "code smell", as we say. Anecdotally I hear lots of stories of CS professors trying to be clever in this way, with them and their students being perpetually frustrated that the auto-grader isn't working exactly as desired. And what's the point of checksum output anyway, versus a yes/no correct output test? Recommendation: Consider grading in ways other than auto-grader alone. Simplify the auto-grader to use a yes/no test suite (<a href="http://codekata.com/kata/kata02-karate-chop/" rel="nofollow noreferrer">example</a>). Increase visibility. </p></li>
<li><p>Second, giving zero credit in any case when the output is not exactly correct. Do you not wish to consider any aspect of a solution being partly correct, or issues of code formatting, readability, documentation, reusability, etc? I think all of those things are important items for which to provide feedback (and hence partial credit). Recommendation: Expand the grading criteria to cover other important issues than just correctness (and secondarily give opportunities for partial credit).</p></li>
<li><p>Third, having half of the grade component judged by competitive ranking of the speed of the programs can have deleterious effects. (a) Pedagogically, it turns the students against each other, and prevents them from sharing knowledge on even the theoretical level (even potentially sabotaging each other). (b) Students will be judged and graded on different criteria across semesters, depending on the strength of their cohort. (c) The focus on speed can take all the oxygen away from students being able to focus on correctness, which should come first (as I've seen back when I taught assembly). Recommendation: Not generally grading on speed, except maybe one special assignment. Failing that, compare to fixed time benchmarks, not relative to other students. </p></li>
<li><p>Fourth, the prize of writing a recommendation letter to only the top-performing student strikes me as somewhere between distasteful and immoral. You should be writing letters for any student who is qualified, in my opinion -- which should be more than 4 per semester. This element gives the signal of a professor who is just lazy and a barrier against student success in principle. Recommendation: Delete this unique "prize" and offer letters openly to more students. </p></li>
<li><p>Fifth, the final assignment takes a little bit too much glee in how unique, "clever" it is, and does a humble-brag about how little time it took the instructor to come up with it and solve it. Again, this smells bad. In  my experience, any test question that I consider "clever" or fun/interesting is a recipe for disaster for my students -- regardless of how elegant or short I can personally make the solution. Recommendation: Assuming you have some quality textbook that you're teaching from, stick to projects from, or similar to those in the book, which have presumably been developed and tested by book authors and reviews over several years and classrooms. </p></li>
</ul>

CC BY-SA 4.0
2019-10-15T04:52:56.190Z
2019-10-18T00:38:46.763Z
2019-10-18T00:38:46.763Z
Daniel R. Collins
<p>I am currently teaching the pretty much normal <a href="https://docs.google.com/document/d/1n498WFcX91trTikJsKAu_UtF1egSsVaNhrE21lcHPpU/edit?usp=sharing" rel="noreferrer">second year Data Structures and Algorithms course</a>. In this course there are four programming projects, with the first project completed the automated testing and grading yesterday. However, out of the 200+ students taking the course, only 72 managed to complete this project so that they passed my automated tester for the pseudorandom seed that I used. As my first question to this forum, I would like to get some second and third opinions about this issue before I decide how deep I dig my heels into the ground about it.</p>

<p>This project (<a href="https://docs.google.com/document/d/12daxoU4SwQN2Yzmk2aU9d7xbkMcxcvQnliNFTXTWPes/edit?usp=sharing" rel="noreferrer">full specification</a>) asked them to create a Java class named IntervalUnion whose objects represent unions of integer intervals, such as [1-5,9-12] or [4-8,11-15], with an arbitrary number of individual intervals allowed inside each such object. This class should then have the public methods union and intersection to create new objects, with the union of these two objects being [1-15] and intersection being [4-5,11-12], along with toString, equals and hashCode as usual.</p>

<p>I simply cannot believe that this project would have been unreasonably difficult for second year computer science majors who have already taken the standard two first year courses of introduction to programming and computer science using Java. And yet for some reason it seemed to be, especially using my automated tester that, based on the given pseudorandom seed, generates random test cases and computes a checksum of the results returned by the implemented methods, this checksum then being expected to be equal to the checksum produced from my private model solution.</p>

<p>For a test run that generated one million objects, easily automated with a Bash shell script, the passing projects took between one and three seconds to finish, whereas some solutions had to be terminated after minutes of waiting and thus rejected. The project spec specified a thirty second time limit that I would have assumed to be more than enough for them even to dilly dally.</p>

<p>Of course I might be completely mistaken in my view about this, so I would like to hear some opinions of other teachers who have taught this same second year intro to algorithms, before I make any announcements to the students.</p>

<p>Since my course uses the three best projects out of four in determining the total course grade, I am currently of the opinion that I am going to just tell the students to wake the hell up, realize that this is serious, and do better in the three remaining projects. <a href="https://docs.google.com/document/d/1MgD841yKzpHJ-hwI9wBg3Y9lWTsX0morpM_63qaeVzw/edit?usp=sharing" rel="noreferrer">The second programming project</a> consists of writing method to remove all nodes with given key from the given linked list, and to sort the given linked list, using the sorting algorithm of their choice. (As with all these projects, the grading is 5 points for passing the automated tester, and 5 points for comparative running time rankings among all submissions.) There is just no way that that task could be considered too hard for second year CS majors.</p>

<p>The last two programming projects ("<a href="https://docs.google.com/document/d/1ffj0WotTvY1WQLUH4uWVEOAHOMaL-RIOa-jMmX6wQZc/edit?usp=sharing" rel="noreferrer">Packing words in bins</a>" and "<a href="https://docs.google.com/document/d/1TikTS0XGeiF-y2v82K7RClWDzZMkdcoZy0637Hk6jGQ/edit?usp=sharing" rel="noreferrer">Word filling</a>") due at the end of the course should be easy to at least pass in that within the simple rules of both word search puzzles, there are really no wrong answers, but the difficulty of both projects is in quickly finding a good solution that scores well.</p>

<p>(As an aside, I am actually pretty proud of that Word filling problem, as its idea came to me last summer during a nice mellow walk, and the solution sketch the next day during a ride home followed by about an hour to implement after dinner, and I wonder if I could be the inventor of such a simple but tricksy puzzle that I simply can't recall ever seeing anywhere before this. Another more interesting variation might be to maximize the scrabble score of the words, since that doesn't actually change the solution algorithm.)</p>

CC BY-SA 4.0
2018-10-09T12:58:04.150Z
How much support do you get from TAs? In particular, what is the ratio of Student to TA? How long do the students have to complete the project?
Buffy
CC BY-SA 4.0
2018-10-09T13:37:56.503Z
This project is considered an exam, so the tas should not help with them. They had five weeks to do the project, considering that the project does not really need anything new from this course but could be done based on what they should have learned the first year.
Ilkka Kokkarinen
CC BY-SA 4.0
2018-10-09T14:17:23.470Z
I wasn't asking about how much help the TAs can give. I would like to know the load of the TAs to help me formulate an answer. Based on your comment, is there any way a student can get any questions answered by you or anyone else about the project (other than your permission to coordinate on "theory")?
Buffy
CC BY-SA 4.0
2018-10-09T15:14:00.680Z
Do you have any logs from the autotester? If they all decided to start the project the night before it was due, that's going to end poorly. I find that to be one of the principle sources of low marks for my students. They do not allocate enough time to debug, etc. It may have worked in the past, but now they are expected to write more complicated programs.
Adam
CC BY-SA 4.0
2018-10-09T16:09:59.803Z
Have the automated tester and your model solution been well validated? Have you inspected any of the failing submissions by hand to verify that they should fail, and why?
Gypsy Spellweaver
CC BY-SA 4.0
2018-10-09T20:44:42.533Z
Sorry for the delay, I was away for a while. The TA's had instructions not to help with the code. The automated tester accepts successfully all top ten submissions no matter which random seed I tried, and each method call has only one correct answer at all times. I think the problem may have been late starting and then not realizing that the project was not easy as they thought it would be.
Ilkka Kokkarinen
CC BY-SA 4.0
2018-10-09T21:27:22.420Z
I have read the problem description carefully. I know how I would solve it with C or Assembly: a big bit array representing the integers from 0 to your specified max. I don't know Java, but apparently C# is similar and I taught that. I do not understand the idea of 'operations', your M parameter. Either the program has consumed and processed all the input or it hasn't. A partially done answer is no answer at all, and if student's algorithms produce different results for values of M insufficient to reach the final result, you can hardly fail them for that. Discard the M parameter and try again.
Scott Rowe
CC BY-SA 4.0
2018-10-09T23:21:08.277Z
I found the requirement description was difficult to understand - it seemed unnecessarily convoluted and artificial to me. It is possible that the students simply couldn't figure out what was expected, since the final class should have been relatively simple.
pojo-guy
CC BY-SA 4.0
2018-10-10T22:45:31.827Z
Did you include any source material about Allen's Interval Algebra? Maybe that was the problem.
Scott Rowe
CC BY-SA 4.0
2019-10-16T15:48:46.770Z
Does you results mean 72 students received 100 and the rest received 0? If not, what was the distribution of results?
Fritz Sieker
<java><project><algorithms><data-structure>
First project in my second year data structures intro
# First project in my second year data structures intro

(Asked by: username_0 on 2018-10-09)

I am currently teaching the pretty much normal [second year Data Structures and Algorithms course](https://docs.google.com/document/d/1n498WFcX91trTikJsKAu_UtF1egSsVaNhrE21lcHPpU/edit?usp=sharing). In this course there are four programming projects, with the first project completed the automated testing and grading yesterday. However, out of the 200+ students taking the course, only 72 managed to complete this project so that they passed my automated tester for the pseudorandom seed that I used. As my first question to this forum, I would like to get some second and third opinions about this issue before I decide how deep I dig my heels into the ground about it.

This project ([full specification](https://docs.google.com/document/d/12daxoU4SwQN2Yzmk2aU9d7xbkMcxcvQnliNFTXTWPes/edit?usp=sharing)) asked them to create a Java class named IntervalUnion whose objects represent unions of integer intervals, such as [1-5,9-12] or [4-8,11-15], with an arbitrary number of individual intervals allowed inside each such object. This class should then have the public methods union and intersection to create new objects, with the union of these two objects being [1-15] and intersection being [4-5,11-12], along with toString, equals and hashCode as usual.

I simply cannot believe that this project would have been unreasonably difficult for second year computer science majors who have already taken the standard two first year courses of introduction to programming and computer science using Java. And yet for some reason it seemed to be, especially using my automated tester that, based on the given pseudorandom seed, generates random test cases and computes a checksum of the results returned by the implemented methods, this checksum then being expected to be equal to the checksum produced from my private model solution.

For a test run that generated one million objects, easily automated with a Bash shell script, the passing projects took between one and three seconds to finish, whereas some solutions had to be terminated after minutes of waiting and thus rejected. The project spec specified a thirty second time limit that I would have assumed to be more than enough for them even to dilly dally.

Of course I might be completely mistaken in my view about this, so I would like to hear some opinions of other teachers who have taught this same second year intro to algorithms, before I make any announcements to the students.

Since my course uses the three best projects out of four in determining the total course grade, I am currently of the opinion that I am going to just tell the students to wake the hell up, realize that this is serious, and do better in the three remaining projects. [The second programming project](https://docs.google.com/document/d/1MgD841yKzpHJ-hwI9wBg3Y9lWTsX0morpM_63qaeVzw/edit?usp=sharing) consists of writing method to remove all nodes with given key from the given linked list, and to sort the given linked list, using the sorting algorithm of their choice. (As with all these projects, the grading is 5 points for passing the automated tester, and 5 points for comparative running time rankings among all submissions.) There is just no way that that task could be considered too hard for second year CS majors.

The last two programming projects ("[Packing words in bins](https://docs.google.com/document/d/1ffj0WotTvY1WQLUH4uWVEOAHOMaL-RIOa-jMmX6wQZc/edit?usp=sharing)" and "[Word filling](https://docs.google.com/document/d/1TikTS0XGeiF-y2v82K7RClWDzZMkdcoZy0637Hk6jGQ/edit?usp=sharing)") due at the end of the course should be easy to at least pass in that within the simple rules of both word search puzzles, there are really no wrong answers, but the difficulty of both projects is in quickly finding a good solution that scores well.

(As an aside, I am actually pretty proud of that Word filling problem, as its idea came to me last summer during a nice mellow walk, and the solution sketch the next day during a ride home followed by about an hour to implement after dinner, and I wonder if I could be the inventor of such a simple but tricksy puzzle that I simply can't recall ever seeing anywhere before this. Another more interesting variation might be to maximize the scrabble score of the words, since that doesn't actually change the solution algorithm.)

**Tags:** java, project, algorithms, data-structure

> **Comments:**
> **username_1**: How much support do you get from TAs? In particular, what is the ratio of Student to TA? How long do the students have to complete the project?  
> **username_0**: This project is considered an exam, so the tas should not help with them. They had five weeks to do the project, considering that the project does not really need anything new from this course but could be done based on what they should have learned the first year.  
> **username_1**: I wasn't asking about how much help the TAs can give. I would like to know the load of the TAs to help me formulate an answer. Based on your comment, is there any way a student can get any questions answered by you or anyone else about the project (other than your permission to coordinate on "theory")?  
> **username_2**: Do you have any logs from the autotester? If they all decided to start the project the night before it was due, that's going to end poorly. I find that to be one of the principle sources of low marks for my students. They do not allocate enough time to debug, etc. It may have worked in the past, but now they are expected to write more complicated programs.  
> **username_3**: Have the automated tester and your model solution been well validated? Have you inspected any of the failing submissions by hand to verify that they should fail, and why?  
> **username_0**: Sorry for the delay, I was away for a while. The TA's had instructions not to help with the code. The automated tester accepts successfully all top ten submissions no matter which random seed I tried, and each method call has only one correct answer at all times. I think the problem may have been late starting and then not realizing that the project was not easy as they thought it would be.  
> **username_4**: I have read the problem description carefully. I know how I would solve it with C or Assembly: a big bit array representing the integers from 0 to your specified max. I don't know Java, but apparently C# is similar and I taught that. I do not understand the idea of 'operations', your M parameter. Either the program has consumed and processed all the input or it hasn't. A partially done answer is no answer at all, and if student's algorithms produce different results for values of M insufficient to reach the final result, you can hardly fail them for that. Discard the M parameter and try again.  
> **username_5**: I found the requirement description was difficult to understand - it seemed unnecessarily convoluted and artificial to me. It is possible that the students simply couldn't figure out what was expected, since the final class should have been relatively simple.  
> **username_4**: Did you include any source material about Allen's Interval Algebra? Maybe that was the problem.  
> **username_6**: Does you results mean 72 students received 100 and the rest received 0? If not, what was the distribution of results?  

---

## 4 answers

### Answer by username_1 on 2018-10-09. Score: 5

Sorry, but digging in your heels or telling the students to wake the hell up is going to get you exactly nowhere. When a small percentage of your students fail to successfully complete a project it is likely their own lack of background or application. But when only about a third are able to successfully complete it, it is a problem with the course, not with them.

Some possible reasons for the problem. Perhaps they started late on it and weren't able to do a good job as user username_2 asked? If so, why was that? Are they overworked generally in your course and elsewhere? I doubt that so many are just late starters. Was it a problem of insufficient testing? Was it too many tried a brute force approach that doesn't scale? How much does the course stress that early on - both testing and scaling? It seems like they weren't able to ask questions (of the TAs at least) as the project progressed. If they get stuck, how do they get unstuck? Just on their own?

I think you have a problem and I can't diagnose it, but you can. You can, for example, have your TAs do a postmortem with small groups. I hope you have more than one or two for 200+ students. The first question I would want the failed students to answer was "Were you surprised by the failure?" That can lead to a lot of discussion about the nature of it. I would ask about how much testing they did, especially on large sets. Were they able to use the tester effectively, providing appropriate inputs, or were they misled by it. Another question I'd want an answer to is how many students now actually know why they failed. What was it in the code or its creation that led them to failure. If they don't know that you have a serious problem going forward. I think that for these and similar questions your TAs are better able to get you usable answers. The students are less likely to feel intimidated by the questions than if you ask them directly.

On another level, I'd ask how many independent runs did you do with each student's work? Just one? The data was random, remember. Maybe naive inputs to the tester gave them poor feedback while doing their own testing.

Maybe a five week project with little guidance or feedback is sub-optimal. Especially if you treat it as an exam. It seems like a lot of time, until it isn't. Why not shorter projects? Why not more feedback? Why not, to be honest, continuous feedback?

I wonder how many students who failed did so only for run time and how many weren't even able to put together an algorithm at all. Has anyone given them feedback on their code and approach other than "failed"?

Are your expectations about what they "should have learned" in the earlier courses realistic? Are you making assumptions not warranted by the facts?

Don't just stamp your feet. Find out why this happened and change your teaching structure accordingly. Treat it like a scientific problem with an engineering solution.

> **Comments:**
> **username_0**: That postmortem is a great idea. I will definitely instruct my TA's to do that in the next week's lab.  
> **username_4**: I saw situations like this in a college course I took in 1984: many students befuddled and unable to develop a working algorithm. We had no automated testing system, and limited access to computer terminals (mainframe environment). As you say, the info about *why* submissions failed is vital to figuring out the OPs problem. Coaching the students in incremental build and test would be valuable.  
> **username_8**: One other potential issue I would add to this answer, somewhat related to the five week issue, is that they just can't fathom the steps necessary to break this problem down. I see this all the time in my CS1 and CS2 courses, even for less complex problems. I would either draw out a suggested timeline (e.g., "complete X method by Friday, Y method by Monday"), or have a check in at some point in time. Depending on the number of TAs you have, you could set up gitlab or something similar for students to check in their code periodically, and the TAs to assess whether they are making progress.  

---

### Answer by username_9 on 2019-10-11. Score: 3

This answer is a complement to username_1's and is more oriented towards future applications of autograding.

The description of the assignment gave me the impression that your autograder is rather lazy. Instead of checking whether the functions the students have written are correct it executes a bunch of operations and compare a checksum of the result. Although this does check if the code is correct, it only produces **right** or **wrong** diagnostics. A small error like using `<` instead of `<=` is undetectable by this method. In other words, the autograder helps you (the instructor) to detect problems in the code, but it does not help students to understand their mistakes.

I prefer using autograders that behave more like unit testing. They go through all functions of the class students defined and test inputs and outputs. If there is something wrong it prints a nice message stating where it fails, for which input and lists current output and expected output. You can still grade only for correct solutions if you want to, but students get much more feedback on their progress. You also get more information about their performance and can see where the failing students made mistakes they could not figure out how to correct. You can even publish a set of "simple" tests and require students to write tests for tricky cases. IMHO this is a much more "modern" approach to grading and it has the added benefit of getting students used to software testing.

If you are not convinced by the argument above, let's explore a more technical perspective. A class is, essentially, a contract that says that a certain number of methods will behave in a certain way. How these methods are implemented should not be of concern to the caller (at least in term of correctness). In this situation, checking each method for correction is a very reasonable approach. It also allows for partial credit: a student that implemented some methods correctly deserves a better (but maybe still failing) grade than a student that did not implement a single method correctly.


---

### Answer by username_10 on 2019-10-15. Score: 2

Late answer: I agree greatly with @username_9's response above (emphasize unit testing with more detailed feedback, not just a "pass/fail" output), so this should be considered in support of that.

I agree with the comment by @username_5 that the specification seems "unnecessarily convoluted and artificial". Having read the specifications for the 1st and 4th projects, the tone also seems a bit snarky in a way that I would not recommend. Have the specification run 5 or 6 pages seems pretty long to me.

But the main thing is that I would recommend you consider changing your grading policies, as several of the terms seem poorly considered. E.g.:

* First, the whole idea of a binary auto-grader with a checksum output seems to have a bad "code smell", as we say. Anecdotally I hear lots of stories of CS professors trying to be clever in this way, with them and their students being perpetually frustrated that the auto-grader isn't working exactly as desired. And what's the point of checksum output anyway, versus a yes/no correct output test? Recommendation: Consider grading in ways other than auto-grader alone. Simplify the auto-grader to use a yes/no test suite ([example](http://codekata.com/kata/kata02-karate-chop/)). Increase visibility.
* Second, giving zero credit in any case when the output is not exactly correct. Do you not wish to consider any aspect of a solution being partly correct, or issues of code formatting, readability, documentation, reusability, etc? I think all of those things are important items for which to provide feedback (and hence partial credit). Recommendation: Expand the grading criteria to cover other important issues than just correctness (and secondarily give opportunities for partial credit).
* Third, having half of the grade component judged by competitive ranking of the speed of the programs can have deleterious effects. (a) Pedagogically, it turns the students against each other, and prevents them from sharing knowledge on even the theoretical level (even potentially sabotaging each other). (b) Students will be judged and graded on different criteria across semesters, depending on the strength of their cohort. (c) The focus on speed can take all the oxygen away from students being able to focus on correctness, which should come first (as I've seen back when I taught assembly). Recommendation: Not generally grading on speed, except maybe one special assignment. Failing that, compare to fixed time benchmarks, not relative to other students.
* Fourth, the prize of writing a recommendation letter to only the top-performing student strikes me as somewhere between distasteful and immoral. You should be writing letters for any student who is qualified, in my opinion -- which should be more than 4 per semester. This element gives the signal of a professor who is just lazy and a barrier against student success in principle. Recommendation: Delete this unique "prize" and offer letters openly to more students.
* Fifth, the final assignment takes a little bit too much glee in how unique, "clever" it is, and does a humble-brag about how little time it took the instructor to come up with it and solve it. Again, this smells bad. In my experience, any test question that I consider "clever" or fun/interesting is a recipe for disaster for my students -- regardless of how elegant or short I can personally make the solution. Recommendation: Assuming you have some quality textbook that you're teaching from, stick to projects from, or similar to those in the book, which have presumably been developed and tested by book authors and reviews over several years and classrooms.


---

### Answer by username_7 on 2018-10-11. Score: 1

Your students do not know how to engineer software. They have not been taught. Teach them. (Suggest you find out what their syllabus has been & what they actually learned.) You do not know how to acquire software. You have been burned. The solution is the same: software engineering. You must be the engineer of your desired software. A software client must be a software manager. You just didn't realize that you assigned yourself a software engineering project.

[The Emperor's Old Clothes](https://cacm.acm.org/magazines/1981/2/10949-the-emperors-old-clothes/pdf):

> At last, there breezed into my office the most senior manager of all, a general manager of our parent company, Andrew St. Johnston. I was surprised that he had even heard of me. "You know what went wrong?" he shouted--he always shouted--"You let your programmers do things which you yourself do not understand."

The core of the solution is the same: milestones. (Which, taking a module to be a unit of work, is just information hiding yet again as the foundation of software engineering.)


---

