Improved documentation and performance notes #600
Description
We may want to have improved documentation (such as it taking me some time to find Shutdown for RPC), and potential API misuse notes such as what was fixed in the decode benchmark in #598.