add note on ring resizing
polish client library warning