adds a few doc comments