Fix #2537: nextSlave is given a list of slavebuilders, not slaves

This is a minor bug in the docs. Adding an example to help cover
the most common usecase of the nextSlave function.
Merge jaredgrubb/buildbot:nextslave-doc-fix (PR #1150)