remove rest-client gem

nothing in chef-client uses it any more.
add docs
Merge pull request #1409 from opscode/lcg/remove-rest-client

remove rest-client gem