adding documentation about Waiting()