better doc comments