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
I assumed math was easier than figuring out two durations.  But I'm fine changing it.