added missing docblocks and comments