improves doc comments