add some doc comments