diff --git a/calendar/README.md b/calendar/README.md
new file mode 100644
index 0000000..23d1235
--- /dev/null
+++ b/calendar/README.md
@@ -0,0 +1,25 @@
+Rolling over to a new year
+==========================
+
+Teaching calendar dates (LaTeX)
+-------------------------------
+
+1. Set up teaching year and periods in `calendar_config.php`.
+2. Run generate_calendar.php and write the output to the appropriate `.tex` file.
+
+
+Teaching calendar dates (XML)
+-----------------------------
+
+1. Go to `$TEACHING_SHARED/Authoring/XML`.
+2. Set up teaching year and periods in `generate_calendar_dates.php`.
+3. `make`.
+
+This should be better integrated one day!
+
+
+Lecture dates
+-------------
+
+1. Set up teaching year, period dates, and paper class offsets in `lecturedates_config.php`.
+2. For each paper, run `generate_lecturedates.php` and write the output to the appropriate `.tex` file.