← All articles

Ship course updates without breaking existing students

Add new lessons carefully: keep URLs stable, mark changes, and avoid moving the goalposts mid-course.

Updating a course is a feature, but it can confuse enrolled students if content moves without warning.

Prefer additive updates: new lessons, new resources, and small edits. If you must replace a lesson, explain what changed at the top of the new version.

Keep links stable. If students bookmarked a lesson, do not make it disappear; redirect or leave a note that points to the replacement.

Finally, announce updates in a predictable way: a short changelog in the course description or a pinned lesson comment.