с каких пор документация стала "чем-то бесполезным" ?)
Что-то вас не в ту степь понесло.
Полезное дело - это то, что заказчик/начальник попросил сделать. Скажем, покрыть такой-то функционал тестами. И у тебя есть два варианта:
1. Вызвать switchTo (alert()), который и ждёт, и переключается, и не тратить время на чтение,
2. Почитать документацию, попытаться понять, почему ты вызываешь waitforalertpresence, а он не переключается; погуглить, поспрашивать в форуме и и.д. и т.п.