diff --git a/contrib/pg_upgrade/TODO b/contrib/pg_upgrade/TODO
new file mode 100644
index 0000000000000000000000000000000000000000..f22d373f80e21b0e0682165dc9df32223802e8b0
--- /dev/null
+++ b/contrib/pg_upgrade/TODO
@@ -0,0 +1,6 @@
+o  remove copy_dir code, or use it
+o  handle large object comments;  this is difficult to do because the large object
+   doesn't exist when --schema-only is loaded
+o  consider using pg_depend for checking object usage in version.c
+o  if reindex is necessary, allow it to be done in parallel with pg_dump custom format
+o  migrate pg_statistic by dumping it out as a flat file, so analyze is not necessary