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.