(QENG-1225) Fix documentation, remove poll value guard.

* Based on PR feedback, adding a polling interval value guard was deemed to be
  unnecessary and overreaching for the scope of this task.
* Removed some unnecessary jenkins puns.
* Minor README documentation clean up--create a sub heading to deal with polling
  behavior explanation.

Signed-off-by: Wayne <wayne@puppetlabs.com>