insert some more strategic sleeps for cleaner test runs, some logging cleanup.
more docs tweaks + warning on pig speculative execution.