altered some documentation comments to be clearer