Improve the wait.Poll GoDoc and api

Add more tests, and allow maxAttempts to be zero to wait forever

@brendandburns addressing your comments from yesterday
Maybe I'm alone in my interpretation of the interface-- @brendandburns?