add documentation and rename was_called to called