added a few minor "this breaks if you remove this" notes