update guide to include better wait, ready and waitOn explanation