changed documentation about waiters