Revise RPC documentation to be more informative.
Previous documentation was more-or-less meant for the Arti developer
only. This new documentation is intended for actual users of RPC
functionality. It's meant to be extracted with maint/rpc-doc-tool
(for which see !2479 (merged)).