updaed method docblock