My CD keeps telling me that my code exercise context needs improvement. I wrote as much about the code as I felt necessary, what else should I be writing?


Good context, not surprisingly, contextualizes an exercise and helps build not only the exercise narrative but the whole course narrative, if done well. It answers the question: why is this code useful? It gives an overview of what the exercise works through, the expected outcomes, and provides a foundation for the student to reflect on when they run into a similar situation in the wild. Thinking about real-world scenarios and concrete examples where this code is useful. Also, remember that you took a lot of time to find the perfect dataset(s) for your course; use this to your advantage and bring this data into the context! Using your dataset to contextualize the exercise is an excellent way to both explain the code and get students to invest in the course.

Did this answer your question?