rpc spec: Start to document method naming convention

All but one of our current methods follows this convention, and we're about to rename it.

Closes #1678 (closed)