gear-placement plugin: improve docs and examples

Noted clearly how server_infos are filtered prior to invoking the plugin
method. Also revised the examples to add logging, adjust idiom, etc.
Merge pull request #5808 from sosiouxme/gear-placement

Merged by openshift-bot