all: add some doc comments

modification times. given that this is the TODO list (really just notes for myself) I don't mind if this is slightly opaque.